Función GetClusterNotifyV2 (clusapi.h)

Artículo
03/08/2023

Recupera información sobre el siguiente evento de notificación para un puerto de notificación.

Sintaxis

DWORD GetClusterNotifyV2(
  [in]                HCHANGE                 hChange,
  [out]               DWORD_PTR               *lpdwNotifyKey,
  [in, out, optional] PNOTIFY_FILTER_AND_TYPE pFilterAndType,
  [in, out, optional] BYTE                    *buffer,
  [in, out, optional] LPDWORD                 lpbBufferSize,
  [in, out, optional] LPWSTR                  lpszObjectId,
  [in, out, optional] LPDWORD                 lpcchObjectId,
  [in, out, optional] LPWSTR                  lpszParentId,
  [in, out, optional] LPDWORD                 lpcchParentId,
  [in, out, optional] LPWSTR                  lpszName,
  [in, out, optional] LPDWORD                 lpcchName,
  [in, out, optional] LPWSTR                  lpszType,
  [in, out, optional] LPDWORD                 lpcchType,
  [in, optional]      DWORD                   dwMilliseconds
);

Parámetros

[in] hChange

Identificador del puerto de notificación. Este identificador lo crea la función CreateClusterNotifyPortV2 .

[out] lpdwNotifyKey

Puntero a la clave de notificación para el puerto de notificación.

[in, out, optional] pFilterAndType

Puntero a una estructura de NOTIFY_FILTER_AND_TYPE que describe el siguiente evento de notificación para el puerto de notificación.

[in, out, optional] buffer

Puntero a un búfer para el evento de notificación.

[in, out, optional] lpbBufferSize

Puntero al tamaño del parámetro de búfer , en bytes.

[in, out, optional] lpszObjectId

Puntero a una cadena Unicode con el identificador del objeto de clúster que desencadenó el evento. La cadena termina con un carácter nulo de terminación.

[in, out, optional] lpcchObjectId

En la entrada, un puntero a un DWORD que especifica el número máximo de caracteres que el parámetro lpszObjectId puede contener, incluido el carácter nulo de terminación. En la salida, un puntero a un DWORD que especifica el número de caracteres que lpszObjectId recibió, excepto el carácter nulo de terminación.

[in, out, optional] lpszParentId

Puntero a una cadena Unicode con el identificador del elemento primario al objeto de clúster que desencadenó el evento. La cadena termina con un carácter nulo de terminación.

[in, out, optional] lpcchParentId

En la entrada, un puntero a un DWORD que especifica el número máximo de caracteres que el parámetro lpszParentId puede contener, incluido el carácter nulo de terminación. En la salida, un puntero a un DWORD que especifica el número de caracteres que lpszParentId recibió, excepto el carácter nulo de terminación.

[in, out, optional] lpszName

Puntero a una cadena Unicode que contiene el nombre del objeto de clúster que desencadenó el evento. La cadena termina con un carácter nulo de terminación.

[in, out, optional] lpcchName

En la entrada, un puntero a un DWORD que especifica el número máximo de caracteres que el parámetro lpszName puede contener, incluido el carácter nulo de terminación. En la salida, un puntero a un DWORD que especifica el número de caracteres que lpszName recibió, excepto el carácter nulo de terminación.

[in, out, optional] lpszType

Puntero a una cadena Unicode que contiene el tipo de objeto de clúster que desencadenó el evento. La cadena termina con un carácter nulo de terminación.

[in, out, optional] lpcchType

En la entrada, un puntero a un DWORD que especifica el número máximo de caracteres que el parámetro lpszType puede contener, incluido el carácter nulo de terminación. En la salida, un puntero a un DWORD que especifica el número de caracteres que lpszType recibió, excepto el carácter nulo de terminación.

[in, optional] dwMilliseconds

Valor de tiempo de espera que especifica cuánto tiempo está dispuesto a esperar la notificación el autor de la llamada.

Valor devuelto

si la operación se realiza correctamente, esta función devuelve ERROR_SUCCESS.

Si se produce un error en la operación, esta función devuelve uno de los siguientes códigos de error del sistema.

Código o valor devuelto	Descripción
ERROR_INVALID_HANDLE 6	El identificador representado en el parámetro hChange no es válido o ha sido cerrado por otro subproceso.
WAIT_TIMEOUT 258 (0x102)	Se agota el tiempo de espera de la llamada antes de que se pueda devolver correctamente la notificación.
ERROR_MORE_DATA 234 (0xEA)	El búfer al que apunta el parámetro lpszName no es lo suficientemente grande como para contener el resultado. El parámetro lpcchName devuelve el número de caracteres en el resultado, excepto el carácter nulo de terminación.

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2012
Plataforma de destino	Windows
Encabezado	clusapi.h
Library	ClusAPI.lib
Archivo DLL	ClusAPI.dll

Consulte también

Función de administración de clústeres de conmutación por error

Compartir a través de