Método IFunctionDiscovery::GetInstance (functiondiscoveryapi.h)

[Detección de funciones está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

Obtiene la instancia de función especificada, en función del identificador.

Sintaxis

HRESULT GetInstance(
  [in]  const WCHAR       *pszFunctionInstanceIdentity,
  [out] IFunctionInstance **ppIFunctionInstance
);

Parámetros

[in] pszFunctionInstanceIdentity

Identificador de la instancia de función (consulte GetID).

[out] ppIFunctionInstance

Puntero a un puntero de interfaz IFunctionInstance usado para devolver la interfaz.

Valor devuelto

Entre los valores devueltos posibles se incluyen, entre otros, los siguientes.

Código o valor devuelto	Descripción
S_OK	El método se completó correctamente.
E_INVALIDARG	El valor de pszFunctionInstanceIdentity no es válido.
E_OUTOFMEMORY	El método no puede asignar la memoria necesaria para realizar esta operación.
HRESULT_FROM_WIN32(ERROR_OBJECT_NOT_FOUND) 0x800710d8	La instancia de función representada por el identificador especificado no existe en este equipo.
E_PENDING	La llamada se ejecutó para un proveedor que devuelve resultados de forma asincrónica.

Comentarios

Algunos proveedores de detección de funciones devuelven sus resultados de consulta con la interfaz IFunctionDiscoveryNotification . GetInstance no encuentra instancias de función que se devuelven de esta manera y producirán un error con E_PENDING. Se recomienda que los clientes usen el método CreateInstanceQuery de la interfaz IFunctionDiscovery para buscar instancias de función para dichos proveedores.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	functiondiscoveryapi.h
Archivo DLL	FunDisc.dll

Consulte también

IFunctionDiscovery