Compartir a través de

PRESOURCE_CONTROL_ROUTINE función de devolución de llamada (resapi.h)

  • Artículo

Realiza una operación que se aplica a un recurso. El tipo PRESOURCE_CONTROL_ROUTINE define un puntero a esta función.

Sintaxis

PRESOURCE_CONTROL_ROUTINE PresourceControlRoutine;

DWORD PresourceControlRoutine(
  [in]            RESID Resource,
  [in]            DWORD ControlCode,
  [in, optional]  PVOID InBuffer,
  [in]            DWORD InBufferSize,
  [out, optional] PVOID OutBuffer,
  [in]            DWORD OutBufferSize,
  [out]           LPDWORD BytesReturned
)
{...}

Parámetros

[in] Resource

Identificador de recursos del recurso afectado.

[in] ControlCode

Código de control que representa la operación que se va a realizar. Para obtener una lista de valores válidos para el parámetro ControlCode , vea Códigos de control de tipo de recurso.

[in, optional] InBuffer

Puntero a un búfer que contiene los datos que se van a usar en la operación. InBuffer puede ser NULL si no se requiere ningún dato.

[in] InBufferSize

Tamaño, en bytes, del búfer al que apunta InBuffer.

[out, optional] OutBuffer

Puntero a un búfer que contiene datos resultantes de la operación. OutBuffer puede ser NULL si la operación no necesita devolver datos.

[in] OutBufferSize

Tamaño, en bytes, del espacio disponible al que apunta OutBuffer.

[out] BytesReturned

Tamaño real, en bytes, de los datos resultantes de la operación.

Valor devuelto

Código o valor devuelto Descripción
ERROR_SUCCESS
0
 La operación asociada a ControlCode se completó correctamente.
ERROR_INVALID_FUNCTION
1
 El archivo DLL de recursos solicitó que el Monitor de recursos realice el procesamiento predeterminado (si existe) para ControlCode , además del procesamiento proporcionado por el archivo DLL (si existe).
ERROR_MORE_DATA
234 (0xEA)
 El tamaño asignado de OutBuffer era demasiado pequeño para contener los datos solicitados. BytesReturned indica el tamaño necesario. Incluya siempre el valor NULL de terminación al calcular los tamaños de bytes de las cadenas.
ERROR_RESOURCE_PROPERTIES_STORED
5024 (0x13A0)
 Indica que se han establecido nuevos valores de propiedad para un recurso en la base de datos del clúster, pero las propiedades aún no han tenido efecto. Los nuevos valores de propiedad se aplicarán después de que el recurso se desconecte y se conecte.
Código de error
 La operación no se realizó correctamente.

Comentarios

Algunos códigos de control deben controlarse mediante el archivo DLL de recursos, mientras que otros deben dejarse en el Monitor de recursos. Para obtener estrategias de implementación eficaces de la función de punto de entrada resourceControl , consulte Implementación de ResourceControl.

Ejemplos

Consulte Ejemplos de DLL de recursos.

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

Consulte también

Funciones de Entry-Point DLL de recursos