Metodo IPortableDeviceContent::CreateObjectWithPropertiesOnly (portabledeviceapi.h)
Il metodo CreateObjectWithPropertiesOnly crea un oggetto con solo le proprietà nel dispositivo.
Sintassi
HRESULT CreateObjectWithPropertiesOnly(
IPortableDeviceValues *pValues,
[in, out] LPWSTR *ppszObjectID
);
Parametri
pValues
Insieme IPortableDeviceValues di proprietà da assegnare all'oggetto . Per un elenco delle proprietà obbligatorie e facoltative per un oggetto, vedere Requisiti per gli oggetti.
[in, out] ppszObjectID
Puntatore di stringa facoltativo per ricevere il nome del nuovo oggetto. Può essere NULL, se non necessario. Dispositivi portatili Windows definisce la costante WPD_DEVICE_OBJECT_ID per rappresentare un dispositivo. L'SDK alloca questa memoria; il chiamante deve rilasciarlo usando CoTaskMemFree.
Valore restituito
Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
Il metodo è riuscito. |
|
Almeno uno degli argomenti obbligatori è un puntatore NULL . |
Commenti
Alcuni oggetti sono solo una raccolta di proprietà, ad esempio una cartella, che è solo una raccolta di puntatori ad altri oggetti, mentre altri oggetti sono sia proprietà che dati, ad esempio un file audio, che contiene tutte le proprietà e i bit musicali effettivi. Questo metodo viene utilizzato per creare un oggetto che contiene solo proprietà. Per creare un oggetto con proprietà e dati, utilizzare CreateObjectWithPropertiesAndData.
Questo metodo è sincrono; quando viene restituito, il nuovo oggetto deve essere presente nel dispositivo.
L'oggetto effettivamente creato dal driver potrebbe essere un oggetto proprietà e dati, a seconda del tipo di oggetto più conveniente per il driver. Per controllare il tipo di oggetto creato dal driver, richiedere la proprietà WPD_OBJECT_FORMAT del nuovo oggetto.
L'oggetto verrà creato nel dispositivo quando termina questo metodo.
Esempio
Per un esempio di come usare questo metodo, vedere Trasferimento di un oggetto Properties-Only al dispositivo.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | portabledeviceapi.h |
| Libreria | PortableDeviceGUIDs.lib |