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
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	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

Weitere Informationen

IPortableDeviceContent-Schnittstelle

Übertragen eines Properties-Only-Objekts auf das Gerät