Share via

Función RtmGetOpaqueInformationPointer (rtmv2.h)

  • Artículo

La función RtmGetOpaqueInformationPointer devuelve un puntero al campo de información opaco de un destino reservado para este cliente. El puntero permite al cliente almacenar información específica del cliente con el destino en la tabla de enrutamiento.

Sintaxis

DWORD RtmGetOpaqueInformationPointer(
  [in]  RTM_ENTITY_HANDLE RtmRegHandle,
  [in]  RTM_DEST_HANDLE   DestHandle,
  [out] PVOID             *OpaqueInfoPointer
);

Parámetros

[in] RtmRegHandle

Identificador para el cliente obtenido de una llamada anterior a RtmRegisterEntity.

[in] DestHandle

Identificador del destino.

[out] OpaqueInfoPointer

En la entrada, OpaqueInfoPointer es un puntero a NULL.

En la salida, OpaqueInfoPointer recibe un puntero al puntero de información opaco. Si un cliente no ha reservado un puntero opaco durante el registro, este parámetro permanece sin cambios.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Valor Significado
ERROR_INVALID_HANDLE
 El identificador no es válido.
ERROR_NOT_FOUND
 El cliente no reservó ningún puntero opaco.
 
 

Comentarios

Para obtener código de ejemplo con esta función, consulte Acceso al puntero opaco en un destino.

Requisitos

   
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado rtmv2.h
Library Rtm.lib
Archivo DLL Rtm.dll

Consulte también

RtmLockDestination