Funzione RpcMgmtEpEltInqNextW (rpcdce.h)

Articolo
11/20/2024

La funzione RpcMgmtEpEltInqNext restituisce un elemento da una mappa endpoint.

Sintassi

RPC_STATUS RpcMgmtEpEltInqNextW(
  RPC_EP_INQ_HANDLE  InquiryContext,
  RPC_IF_ID          *IfId,
  RPC_BINDING_HANDLE *Binding,
  UUID               *ObjectUuid,
  RPC_WSTR           *Annotation
);

Parametri

InquiryContext

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

IfId

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

Binding

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

ObjectUuid

Opzionale. Restituisce l'UUID dell'oggetto dall'elemento endpoint-map.

Annotation

Opzionale. 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

Valore	Significato
RPC_S_OK	Chiamata riuscita.

Nota Per un elenco di codici di errore validi, vedere RPC Return Values.

Osservazioni

La funzione RpcMgmtEpEltInqNext restituisce un elemento dalla mappa endpoint. Gli elementi selezionati dipendono dal contesto di richiesta. I criteri di selezione sono determinati dalla 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 rpc di runtime alloca memoria per Binding e annotazione su ogni chiamata a questa funzione. L'applicazione è responsabile della chiamata 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.

Nota

L'intestazione rpcdce.h definisce RpcMgmtEpEltInqNext come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	rpcdce.h (include Rpc.h)
libreria	Rpcrt4.lib
dll	Rpcrt4.dll

Vedere anche

RpcEpRegister

RpcMgmtEpEltInqBegin

RpcMgmtEpEltInqDone

Condividi tramite