Metodo IFunctionInstance::GetCategory (functiondiscoveryapi.h)

[L'individuazione delle funzioni è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive.]

Ottiene la categoria e le stringhe di sottocategoria per l'istanza della funzione.

Sintassi

HRESULT GetCategory(
  [out] WCHAR **ppszCoMemCategory,
  [out] WCHAR **ppszCoMemSubCategory
);

Parametri

[out] ppszCoMemCategory

Stringa dell'identificatore con terminazione Null della categoria. Vedere Definizioni di categoria.

Assicurarsi di liberare questo buffer usando CoTaskMemFree.

[out] ppszCoMemSubCategory

Stringa dell'identificatore con terminazione Null della sottocategoria. Vedere Definizioni di sottocategoria.

Valore restituito

I valori restituiti possibili includono, ma non sono limitati ai valori seguenti.

Codice restituito	Descrizione
S_OK	Metodo completato correttamente.
E_OUTOFMEMORY	Il metodo non è in grado di allocare la memoria necessaria per eseguire questa operazione.

Commenti

La categoria e la sottocategoria di un'istanza di funzione fanno sempre riferimento alla categoria del provider da cui proviene un'istanza di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	functiondiscoveryapi.h
DLL	FunDisc.dll

Vedi anche

IFunctionInstance