Función ResUtilGetResourceNameDependency (resapi.h)

Artículo
08/25/2023

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

Sintaxis

HRESOURCE ResUtilGetResourceNameDependency(
  [in] LPCWSTR lpszResourceName,
  [in] LPCWSTR lpszResourceType
);

Parámetros

[in] lpszResourceName

Cadena Unicode terminada en NULL que especifica el nombre 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.

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 lpszResourceName . 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 ResUtilGetResourceNameDependency, ResUtilGetResourceDependency y ResUtilGetResourceDependencyByName 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 ResUtilGetResourceNameDependency desde cualquier función de punto de entrada dll de recurso. Se puede llamar a ResUtilGetResourceNameDependency 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 ResUtilGetResourceNameDependency para obtener un identificador de la dependencia.

// String initialization and error checking omitted.

HRESOURCE hResD = ResUtilGetResourceNameDependency(
                        L"Resource_A_Name",
                        L"Physical Disk" );

// Close handles and free memory.

Requisitos


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