Funzione WsGetMetadataProperty (webservices.h)

Articolo
03/15/2023

Recupera una proprietà dell'oggetto WS_METADATA specificata. La proprietà da recuperare è identificata da un parametro di input WS_METADATA_PROPERTY_ID .

Nota I dati restituiti da questa funzione sono validi fino a quando l'oggetto metadati non viene rilasciato o reimpostato. I dati non devono essere modificati.

Sintassi

HRESULT WsGetMetadataProperty(
  [in]           WS_METADATA             *metadata,
  [in]           WS_METADATA_PROPERTY_ID id,
                 void                    *value,
  [in]           ULONG                   valueSize,
  [in, optional] WS_ERROR                *error
);

Parametri

[in] metadata

Puntatore a un oggetto Metadata contenente la proprietà desiderata. Questo parametro deve essere un oggetto WS_METADATA valido.

[in] id

Valore dell'identificatore della proprietà da recuperare.

value

Riferimento a un percorso per l'archiviazione del valore della proprietà recuperata. Il puntatore deve avere un allineamento compatibile con il tipo della proprietà .

[in] valueSize

Dimensione del buffer di lunghezza byte allocata dal chiamante per archiviare il valore della proprietà recuperato.

[in, optional] error

Puntatore a un oggetto WS_ERROR in cui devono essere archiviate informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
E_INVALIDARG	L'ID della proprietà non è supportato per questo oggetto o il buffer specificato non è abbastanza grande per il valore.
E_OUTOFMEMORY	Memoria insufficiente.
Altri errori	Questa funzione può restituire altri errori non elencati in precedenza.

Requisiti


Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	webservices.h
Libreria	WebServices.lib
DLL	WebServices.dll

Condividi tramite