Funzione RpcNsEntryObjectInqNext (rpcnsi.h)
La funzione RpcNsEntryObjectInqNext restituisce un oggetto alla volta da una voce del database name-service.
Sintassi
RPC_STATUS RpcNsEntryObjectInqNext(
RPC_NS_HANDLE InquiryContext,
UUID *ObjUuid
);
Parametri
InquiryContext
Handle name-service che indica gli UUID dell'oggetto per una voce di database name-service.
ObjUuid
Restituisce un puntatore a un oggetto esportato UUID.
Valore restituito
| Valore | Significato |
|---|---|
|
La chiamata ha avuto esito positivo. |
|
Nessun altro membro. |
|
Il nome è incompleto. |
|
Non è stata trovata la voce nome-servizio. |
|
Il servizio nome non è disponibile. |
Commenti
La funzione RpcNsEntryObjectInqNext restituisce uno degli UUID oggetto esportati nella voce del database name-service specificata dal parametro EntryName nella funzione RpcNsEntryObjectInqBegin .
Un'applicazione può visualizzare tutti gli UUID dell'oggetto esportato chiamando ripetutamente RpcNsEntryObjectInqNext. Quando sono stati visualizzati tutti gli UUID dell'oggetto, questa funzione restituisce un codice di stato RPC_S_NO_MORE_MEMBERS. Gli UUID restituiti vengono ordinati.
L'applicazione fornisce la memoria per l'oggetto UUID restituito nel parametro ObjUuid .
Dopo aver visualizzato gli UUID dell'oggetto, l'applicazione deve chiamare la funzione RpcNsEntryObjectInqDone per rilasciare il contesto di richiesta.
L'ordine in cui vengono restituiti gli UUID dell'oggetto può essere diverso per ogni visualizzazione di una voce. Ciò significa che l'ordine in cui vengono restituiti gli UUID dell'oggetto a un'applicazione può essere diverso ogni volta che l'applicazione viene eseguita.
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 | rpcnsi.h (include Rpc.h) |
| Libreria | Rpcns4.lib |
| DLL | Rpcns4.dll |