Funzione RpcMgmtEpEltInqNext (rpcdce.h)

La funzione RpcMgmtEpEltInqNext restituisce un elemento da una mappa endpoint.

Sintassi

RPC_STATUS RpcMgmtEpEltInqNext(
  RPC_EP_INQ_HANDLE  InquiryContext,
  RPC_IF_ID          *IfId,
  RPC_BINDING_HANDLE *Binding,
  RPC_CSTR           *Annotation
);

Parametri

InquiryContext

Specifica un contesto di richiesta. Il contesto di richiesta viene restituito da RpcMgmtEpEltInqBegin.

IfId

Restituisce l'identificatore di interfaccia dell'elemento endpoint-map.

Binding

facoltativo. Restituisce l'handle di associazione dall'elemento endpoint-map.

Annotation

facoltativo. Restituisce la stringa di annotazione per l'elemento endpoint-map. Quando non è presente alcuna stringa di annotazione nell'elemento endpoint-map, viene restituita la stringa vuota ("").

Valore restituito

Commenti

La funzione RpcMgmtEpEltInqNext restituisce un elemento dalla mappa endpoint. Gli elementi selezionati dipendono dal contesto della richiesta. I criteri di selezione sono determinati da InquiryType della funzione RpcMgmtEpEltInqBegin che ha restituito InquiryContext.

Un'applicazione può visualizzare tutti gli elementi della mappa endpoint selezionati chiamando ripetutamente RpcMgmtEpEltInqNext. Quando tutti gli elementi sono stati visualizzati, questa funzione restituisce uno stato RPC_X_NO_MORE_ENTRIES. Gli elementi restituiti non sono ordinati.

Quando i rispettivi argomenti sono diversi da NULL, la libreria di funzioni di runtime RPC alloca memoria per Binding e Annotation per ogni chiamata a questa funzione. L'applicazione è responsabile della chiamata di RpcBindingFree per ogni binding restituito e RpcStringFree per ogni annotazione restituita.

Dopo aver visualizzato gli elementi della mappa endpoint, l'applicazione deve chiamare RpcMgmtEpEltInqDone per eliminare il contesto di richiesta.

Requisiti

Vedi anche

RpcEpRegister

RpcMgmtEpEltInqBegin

RpcMgmtEpEltInqDone