documentForSubmission( )

Returns a document for submission.

Interface

PODSDocumentSrc

IDL definition

PODSDocument documentForSubmission(
  PODSSubmission submission,
  out PODSBoolean handled
);

JavaScript synopsis

Not applicable

C synopsis

PODSDocument* PODSdocumentForSubmission(
  PODSDocumentSrc* docsrc,
  PODSSubmission* submission,
  PODSBoolean* handled
);

Parameters

docsrc The PODSDocumentSrc object.
submission [in] The PODSSubmission object.
handled [out] Indicates whether the request was handled successfully: PODS_TRUE on success; PODS_FALSE otherwise. You may return handled as PODS_TRUE while returning a null PODSDocument. For example, you might want to have a link with a URL that does not return a page, but toggles the device backlighting; the URL would be something like "PODS://togglebacklight".

Returns

PODSDocument object for specified submission. May be NULL.

Remarks

Your document source should implement this method or documentForUrl( ).

The PODSDocumentSrc implementation of documentForSubmission( ) only checks the specified document source, while the PODSDocumentMgr implementation walks through all the registered document sources until a document with a matching submission object is found.