Método IFunctionInstance::GetID (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 cadena de identificador de la instancia de función. Este identificador se puede guardar y usar más adelante para volver a consultar la misma instancia de función a través de IFunctionDiscovery::GetInstance.

Sintaxis

HRESULT GetID(
  [out] WCHAR **ppszCoMemIdentity
);

Parámetros

[out] ppszCoMemIdentity

Cadena de identificador de instancia de función. No hay ningún límite superior en el tamaño de esta cadena.

Esta cadena es una cadena compuesta generada por la detección de funciones. Tiene la cadena de identificador de instancia del proveedor como una subcadena. Para obtener más información sobre los identificadores de proveedor, vea IFunctionInstance::GetProviderInstanceID.

En el caso de las instancias de función devueltas por un proveedor integrado, se garantiza que este identificador identifique de forma única un recurso en un sistema, incluso si el recurso está desconectado y se vuelve a conectar. En el caso de las instancias de función devueltas por proveedores personalizados, el identificador de instancia de función es único si el proveedor tiene un identificador de proveedor único.

Este identificador no se debe manipular ni fabricar mediante programación. La cadena solo se debe usar para recuperar instancias de función y con fines de comparación.

Asegúrese de liberar este búfer con CoTaskMemFree.

Valor devuelto

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

Código devuelto	Descripción
S_OK	El método se completó correctamente.
E_INVALIDARG	El valor de ppszCoMemID no es válido.
E_OUTOFMEMORY	El método no puede asignar la memoria necesaria para realizar esta operación.

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

IFunctionInstance