Función ResUtilGetResourceDependency (resapi.h)

Artículo
03/08/2023

Enumera las dependencias de un recurso especificado y devuelve un identificador a una dependencia de un tipo especificado. El tipo PRESUTIL_GET_RESOURCE_DEPENDENCY define un puntero a esta función.

Sintaxis

HRESOURCE ResUtilGetResourceDependency(
  [in] HANDLE  hSelf,
  [in] LPCWSTR lpszResourceType
);

Parámetros

[in] hSelf

Controle el recurso dependiente. Este recurso depende de uno o varios recursos.

[in] lpszResourceType

Cadena Unicode terminada en NULL que especifica el tipo de recurso de la dependencia que se va a devolver.

Valor devuelto

Si la operación se realiza correctamente, la función devuelve un identificador a uno de los recursos en los que depende el recurso especificado por hSelf . El autor de la llamada es responsable de cerrar el identificador mediante una llamada a CloseClusterResource.

Si se produce un error en la operación, la función devuelve NULL. Para obtener más información, llame a la función GetLastError .

Comentarios

Las funciones ResUtilGetResourceDependency, ResUtilGetResourceDependencyByName y ResUtilGetResourceNameDependency son muy similares en que todas proporcionan acceso a las dependencias de un tipo de recurso determinado. En la tabla siguiente se resumen las diferencias entre las funciones.

Función	Cómo se especifica el recurso dependiente	Requiere el identificador del clúster
ResUtilGetResourceDependency	Identificador de recursos	No
ResUtilGetResourceDependencyByName	Identificador de recursos	Sí
ResUtilGetResourceNameDependency	Nombre del recurso	No

No llame a ResUtilGetResourceDependency desde cualquier función de punto de entrada dll de recurso. Se puede llamar a ResUtilGetResourceDependency de forma segura desde un subproceso de trabajo. Para obtener más información, consulte Llamadas de función para evitar en archivos DLL de recursos.

Ejemplos

Como se muestra en el ejemplo siguiente, si sabe que el recurso A depende de un recurso de disco físico, puede usar ResUtilGetResourceDependency para obtener un identificador para la dependencia.

// String initialization and error checking omitted.

HCLUSTER hCluster = OpenCluster( lpszClusterName );

//
// Resource A depends on a Physical Disk resource.
// Get a handle to that resource.
//
HRESOURCE hResA = OpenClusterResource( hCluster, lpszResName );

HRESOURCE hResD = ResUtilGetResourceDependency(
                        hResA,
                        L"Physical Disk" );

// Close handles and free memory.

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Plataforma de destino	Windows
Encabezado	resapi.h
Library	ResUtils.lib
Archivo DLL	ResUtils.dll