Funzione RtmGetOpaqueInformationPointer (rtmv2.h)

La funzione RtmGetOpaqueInformationPointer restituisce un puntatore al campo informativo opaco in una destinazione riservata per questo client. Il puntatore consente al client di archiviare informazioni specifiche del client con la destinazione nella tabella di routing.

Sintassi

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

Parametri

[in] RtmRegHandle

Gestire il client ottenuto da una chiamata precedente a RtmRegisterEntity.

[in] DestHandle

Gestire nella destinazione.

[out] OpaqueInfoPointer

In input , OpaqueInfoPointer è un puntatore a NULL.

Nell'output , OpaqueInfoPointer riceve un puntatore al puntatore informativo opaco. Se un client non ha riservato un puntatore opaco durante la registrazione, questo parametro rimane invariato.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_INVALID_HANDLE	Handle non valido.
ERROR_NOT_FOUND	Nessun puntatore opaco è stato riservato dal client.

 

 

Commenti

Per codice di esempio usando questa funzione, vedere Accedere al puntatore opaco in una destinazione.

Requisiti

Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	rtmv2.h
Libreria	Rtm.lib
DLL	Rtm.dll

Vedi anche

RtmLockDestination