IPortableDeviceContent::CreateObjectWithPropertiesOnly-Methode (portabledeviceapi.h)
Die CreateObjectWithPropertiesOnly-Methode erstellt ein -Objekt mit nur Eigenschaften auf dem Gerät.
Syntax
HRESULT CreateObjectWithPropertiesOnly(
IPortableDeviceValues *pValues,
[in, out] LPWSTR *ppszObjectID
);
Parameter
pValues
Eine IPortableDeviceValues-Auflistung von Eigenschaften, die dem Objekt zugewiesen werden sollen. Eine Liste der erforderlichen und optionalen Eigenschaften für ein Objekt finden Sie unter Anforderungen für Objekte.
[in, out] ppszObjectID
Ein optionaler Zeichenfolgenzeiger zum Empfangen des Namens des neuen Objekts. Kann NULL sein, falls nicht erforderlich. Windows Portable Devices definiert die konstante WPD_DEVICE_OBJECT_ID, um ein Gerät darzustellen. Das SDK weist diesen Arbeitsspeicher zu. Der Aufrufer muss es mithilfe von CoTaskMemFree freigeben.
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 erforderlichen Argumente war ein NULL-Zeiger . |
Hinweise
Einige Objekte sind nur eine Auflistung von Eigenschaften, z. B. ein Ordner, bei dem es sich nur um eine Sammlung von Zeigern auf andere Objekte handelt, während andere Objekte sowohl Eigenschaften als auch Daten sind, z. B. eine Audiodatei, die alle Eigenschaften und die tatsächlichen Musikbits enthält. Diese Methode wird verwendet, um ein Objekt zu erstellen, das nur Eigenschaften enthält. Um ein Objekt mit Eigenschaften und Daten zu erstellen, verwenden Sie CreateObjectWithPropertiesAndData.
Diese Methode ist synchron; wenn es zurückgegeben wird, sollte das neue Objekt auf dem Gerät vorhanden sein.
Das Objekt, das der Treiber tatsächlich erstellt, kann ein properties-and-data-Objekt sein, je nachdem, welcher Objekttyp für den Treiber am bequemsten ist. Um zu überprüfen, welche Art von Objekt der Treiber erstellt hat, fordern Sie die WPD_OBJECT_FORMAT-Eigenschaft des neuen Objekts an.
Das -Objekt wird auf dem Gerät erstellt, wenn diese Methode zurückgibt.
Beispiele
Ein Beispiel für die Verwendung dieser Methode finden Sie unter Übertragen eines Properties-Only-Objekts auf das Gerät.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | portabledeviceapi.h |
| Bibliothek | PortableDeviceGUIDs.lib |