Función ResUtilGetResourceDependencyByName (resapi.h)

Artículo
08/25/2023

Enumera las dependencias de un recurso especificado en un clúster especificado y devuelve un identificador a una dependencia de un tipo especificado. El tipo PRESUTIL_GET_RESOURCE_DEPENDENCY_BY_NAME define un puntero a esta función.

Sintaxis

HRESOURCE ResUtilGetResourceDependencyByName(
  [in] HCLUSTER hCluster,
  [in] HANDLE   hSelf,
  [in] LPCWSTR  lpszResourceType,
  [in] BOOL     bRecurse
);

Parámetros

[in] hCluster

Identificador del clúster al que pertenece el recurso.

[in] hSelf

Identificador del 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.

[in] bRecurse

Determina el ámbito de la búsqueda. Si es TRUE, la función comprueba todo el árbol de dependencias en el recurso dependiente. Si es FALSE, la función comprueba solo los recursos en los que depende directamente el recurso dependiente.

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 .

Código devuelto	Descripción
HRESOURCE
NULL	La operación no se realizó correctamente. Para obtener más información, llame a la función GetLastError.

Comentarios

Las funciones ResUtilGetResourceDependencyByName, ResUtilGetResourceDependency y ResUtilGetResourceNameDependency son muy similares en que todas proporcionan acceso a las dependencias de un tipo de recurso determinado. En la lista 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 ResUtilGetResourceDependencyByName desde cualquier función de punto de entrada dll de recurso. Se puede llamar a ResUtilGetResourceDependencyByName 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 ResUtilGetResourceDependencyByName para obtener un identificador de la dependencia.

// String initialization and error checking omitted.

HCLUSTER hCluster = OpenCluster( lpszClusterName );

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

HRESOURCE hResD = ResUtilGetResourceDependencyByName(
                        hCluster,
                        hResA,
                        L"Physical Disk",
                        TRUE );

// 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