IPortableDeviceResources::CreateResource-Methode (portabledeviceapi.h)
Die CreateResource-Methode erstellt eine Ressource.
Syntax
HRESULT CreateResource(
[in] IPortableDeviceValues *pResourceAttributes,
[out] IStream **ppData,
[out] DWORD *pdwOptimalWriteBufferSize,
[out] LPWSTR *ppszCookie
);
Parameter
[in] pResourceAttributes
Zeiger auf die folgenden Objektparameterattribute.
| attribute | BESCHREIBUNG |
|---|---|
| WPD_OBJECT_NAME | Der Name des Objekts. |
| WPD_RESOURCE_ATTRIBUTE_TOTAL_SIZE | Die Gesamtgröße des Ressourcendatenstroms. |
| WPD_RESOURCE_ATTRIBUTE_FORMAT | Das Format des Ressourcendatenstroms. |
| WPD_RESOURCE_ATTRIBUTE_RESOURCE_KEY | Ein Ressourcenschlüssel. |
[out] ppData
Zeiger auf einen Stream, in den der Aufrufer Ressourcendaten schreiben kann.
[out] pdwOptimalWriteBufferSize
Zeiger auf einen Wert, der die optimale Puffergröße beim Schreiben in den Stream angibt. Dieser Parameter ist optional.
[out] ppszCookie
Zeiger auf ein Cookie, das die Ressourcenerstellungsanforderung identifiziert. Dieser Parameter ist optional.
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Mindestens eines der Argumente war ein NULL-Zeiger . |
Hinweise
Wenn eine Anwendung diese Methode aufruft, muss sie die Ressourcenattribute angeben und die erforderlichen Daten in den Stream schreiben, den diese Methode zurückgibt.
Eine Ressource wird nicht erstellt, wenn die Methode zurückgibt. Sie wird erstellt, wenn die Anwendung die Daten durch Aufruf der Commit-Methode für den Stream aufruft, an dem ppData verweist.
Um die Datenübertragung an eine Ressource abzubrechen, muss die Anwendung die Revert-Methode für den Stream aufrufen, an dem ppData-Punkte stehen. Sobald die Übertragung abgebrochen wurde, muss die Anwendung IUnknown::Release aufrufen, um den Stream zu schließen.
Requirements (Anforderungen)
| Zielplattform | Windows |
| Kopfzeile | portabledeviceapi.h |
| Bibliothek | PortableDeviceGUIDs.lib |