Funzione RpcMgmtEpEltInqBegin (rpcdce.h)

Articolo
08/25/2023

La funzione RpcMgmtEpEltInqBegin crea un contesto di richiesta per visualizzare gli elementi in una mappa dell'endpoint.

Sintassi

RPC_STATUS RpcMgmtEpEltInqBegin(
  RPC_BINDING_HANDLE EpBinding,
  unsigned long      InquiryType,
  RPC_IF_ID          *IfId,
  unsigned long      VersOption,
  UUID               *ObjectUuid,
  RPC_EP_INQ_HANDLE  *InquiryContext
);

Parametri

EpBinding

Handle di associazione a un host i cui elementi di mapping degli endpoint devono essere visualizzati. Specificare NULL per visualizzare gli elementi dall'host locale. Se viene specificato un handle di associazione, l'oggetto UUID nell'handle di associazione deve essere NULL. Se presente, l'endpoint nell'handle di associazione viene ignorato e viene usato l'endpoint del database del mapper endpoint nell'host specificato.

InquiryType

Valore intero che indica il tipo di richiesta da eseguire sulla mappa dell'endpoint. Di seguito sono riportati tipi di richiesta validi.

Valore	Significato
RPC_C_EP_ALL_ELTS	Restituisce ogni elemento dalla mappa dell'endpoint. I parametri IfId, VersOption e ObjectUuid vengono ignorati.
RPC_C_EP_MATCH_BY_IF	Cerca il mapping dell'endpoint per gli elementi che contengono l'identificatore dell'interfaccia specificato dai valori IfId e VersOption .
RPC_C_EP_MATCH_BY_OBJ	Cerca la mappa dell'endpoint per gli elementi che contengono l'oggetto UUID specificato da ObjectUuid.
RPC_C_EP_MATCH_BY_BOTH	Cerca la mappa dell'endpoint per gli elementi che contengono l'identificatore dell'interfaccia e l'UUID dell'oggetto specificati da IfId, VersOption e ObjectUuid.

IfId

Identificatore dell'interfaccia degli elementi della mappa degli endpoint da restituire da RpcMgmtEpEltInqNext. Questo parametro viene usato solo quando InquiryType è RPC_C_EP_MATCH_BY_IF o RPC_C_EP_MATCH_BY_BOTH. In caso contrario, viene ignorata.

VersOption

Specifica il modo in cui RpcMgmtEpEltInqNext usa il parametro IfId . Questo parametro viene usato solo quando InquiryType è RPC_C_EP_MATCH_BY_IF o RPC_C_EP_MATCH_BY_BOTH. In caso contrario, viene ignorata. Di seguito sono riportati valori validi per questo parametro.

Valore	Significato
RPC_C_VERS_ALL	Restituisce gli elementi della mappa degli endpoint che offrono l'UUID dell'interfaccia specificata, indipendentemente dai numeri di versione.
RPC_C_VERS_COMPATIBLE	Restituisce gli elementi della mappa degli endpoint che offrono la stessa versione principale dell'UUID dell'interfaccia specificata e una versione secondaria maggiore o uguale alla versione secondaria dell'interfaccia specificata UUID.
RPC_C_VERS_EXACT	Restituisce gli elementi della mappa degli endpoint che offrono la versione specificata dell'UUID dell'interfaccia specificata.
RPC_C_VERS_MAJOR_ONLY	Restituisce gli elementi della mappa degli endpoint che offrono la stessa versione principale dell'UUID dell'interfaccia specificata e ignora la versione secondaria.
RPC_C_VERS_UPTO	Restituisce gli elementi della mappa degli endpoint che offrono una versione dell'UUID dell'interfaccia specificata minore o uguale alla versione principale e secondaria specificata.

ObjectUuid

L'oggetto UUID che RpcMgmtEpEltInqNext cerca negli elementi della mappa degli endpoint. Questo parametro viene usato solo quando InquiryType è RPC_C_EP_MATCH_BY_OBJ o RPC_C_EP_MATCH_BY_BOTH.

InquiryContext

Restituisce un contesto di richiesta da usare con RpcMgmtEpEltInqNext e RpcMgmtEpEltInqDone. Vedere RPC_EP_INQ_HANDLE.

Valore restituito

Valore	Significato
RPC_S_OK	La chiamata ha avuto esito positivo.

Nota Per un elenco di codici di errore validi, vedere Valori restituiti RPC.

Commenti

La funzione RpcMgmtEpEltInqBegin crea un contesto di richiesta per visualizzare le informazioni sull'indirizzo del server archiviate nella mappa dell'endpoint. Usando InquiryType e VersOption, un'applicazione specifica quali dei seguenti elementi di mapping degli endpoint devono essere restituiti dalle chiamate a RpcMgmtEpEltInqNext:

Tutti gli elementi
Tali elementi con l'identificatore di interfaccia specificato
Tali elementi con l'oggetto specificato UUID
Tali elementi con l'identificatore dell'interfaccia e l'UUID dell'oggetto specificati

Prima di chiamare RpcMgmtEpEltInqNext, l'applicazione deve prima chiamare questa funzione per creare un contesto di richiesta. Dopo aver visualizzato gli elementi del mapping degli endpoint, l'applicazione chiama RpcMgmtEpEltInqDone per eliminare il contesto di richiesta.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	rpcdce.h (include Rpc.h)
Libreria	Rpcrt4.lib
DLL	Rpcrt4.dll

Vedi anche

RpcEpRegister

RpcMgmtEpEltInqDone

RpcMgmtEpEltInqNext

Condividi tramite