Funzione RpcServerUseProtseqExW (rpcdce.h)
La funzione rpcServerUseProtseqEx
Sintassi
RPC_STATUS RpcServerUseProtseqExW(
RPC_WSTR Protseq,
unsigned int MaxCalls,
void *SecurityDescriptor,
PRPC_POLICY Policy
);
Parametri
Protseq
Puntatore a un identificatore stringa della sequenza di protocollo da registrare con la libreria di runtime RPC.
MaxCalls
Lunghezza della coda di backlog per la sequenza di protocollo ncacn_ip_tcp. Tutte le altre sequenze di protocollo ignorano questo parametro. Usare RPC_C_PROTSEQ_MAX_REQS_DEFAULT per specificare il valore predefinito. Vedere la sezione Osservazioni.
SecurityDescriptor
Puntatore a un parametro facoltativo fornito per il sottosistema di sicurezza Windows XP/2000/NT. Usato solo per ncacn_np e sequenze di protocollo ncalrpc. Tutte le altre sequenze di protocollo ignorano questo parametro. Non è consigliabile usare un descrittore di sicurezza nell'endpoint per proteggere un server. Questo parametro non viene visualizzato nella specifica DCE per questa API.
Policy
Puntatore alla struttura RPC_POLICY, che contiene flag per limitare l'allocazione delle porte per le porte dinamiche e consentire ai computer multihomed di eseguire l'associazione selettiva alle schede di interfaccia di rete. La struttura RPC_POLICY consente al chiamante di indirizzare la libreria di runtime RPC a usare una porta Intranet o una porta Internet, tra le altre opzioni.
Valore restituito
| Valore | Significato |
|---|---|
|
Chiamata riuscita. |
|
La sequenza di protocollo non è supportata in questo host. |
|
Sequenza di protocollo. |
|
Il sistema non è in memoria. |
|
Il descrittore di sicurezza non è valido. |
Osservazioni
I parametri e gli effetti di RpcServerUseProtseqEx sottosumono quelli di RpcServerUseProtseq. La differenza è il campo criteri di
L'impostazione del campo NICFlags della struttura RPC_POLICY su zero rende questa funzione estesa equivalente funzionalmente all'originale RpcServerUseProtseqe il server verrà associato alle schede di interfaccia di rete in base alle impostazioni nel Registro di sistema. Per informazioni, vedere Configurazione del Registro di sistema per le allocazioni di porte e l'associazione selettiva.
Per ogni sequenza di protocollo registrata da un server, la libreria di runtime RPC crea uno o più endpoint tramite cui il server riceve richieste di chiamata di procedura remota. La libreria di runtime RPC crea endpoint diversi per ogni sequenza di protocollo. Il nome dell'endpoint viene generato dal tempo di esecuzione RPC o dal sistema operativo. Ad esempio, per ncacn_ip_tcp, il numero di porta viene determinato dinamicamente dal tempo di esecuzione RPC, a seconda della disponibilità e delle impostazioni del Registro di sistema.
Per MaxCalls, il valore fornito dall'applicazione è solo un hint. Il runtime RPC o il provider Windows Sockets può eseguire l'override del valore. Ad esempio, in Windows XP o Windows 2000 Professional, il valore è limitato a 5. I valori maggiori di 5 vengono ignorati e 5 vengono invece usati. In Windows Server 2003 e Windows 2000 Server il valore verrà rispettato.
Le applicazioni devono prestare attenzione a passare valori ragionevoli in MaxCalls. I valori di grandi dimensioni nel server, nel server avanzato o nel server datacenter possono causare l'utilizzo di una grande quantità di memoria del pool non di paging. Anche l'uso di un valore troppo piccolo non è favorevole, perché può comportare l'esaurimento dei pacchetti TCP SYN da parte di TCP RST dal server. Uno sviluppatore di applicazioni deve bilanciare il footprint di memoria rispetto ai requisiti di scalabilità quando si determina il valore appropriato per MaxCalls.
Quando il computer è configurato per l'utilizzo dell'associazione selettiva, la restituzione riuscita non garantisce che il server abbia creato endpoint per tutte le interfacce di rete presenti nel computer. Il runtime RPC potrebbe non essere in ascolto su alcune interfacce di rete a seconda delle impostazioni di associazione selettiva. Inoltre, se un'interfaccia non ha ancora ricevuto un indirizzo IP tramite DHCP, il server RPC non è in ascolto sull'interfaccia di rete finché non viene assegnato un indirizzo DHCP. Una restituzione riuscita implica che il server è in ascolto su almeno un'interfaccia di rete; L'elenco completo degli handle di associazione su cui è possibile ricevere chiamate di routine remote con una chiamata alla funzione RpcServerInqBindings.
Per registrare tutte le sequenze di protocollo, un server chiama routine RpcServerUseAllProtseqsEx.
Per altre informazioni, vedere Server-Side Binding.
Nota
L'intestazione rpcdce.h definisce RpcServerUseProtseqEx 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 |