struttura RPC_POLICY (rpcdce.h)
La struttura RPC_POLICY contiene flag che determinano l'associazione nei computer multihomed e le allocazioni delle porte quando si usano i protocolli ncacn_ip_tcp e ncadg_ip_udp .
Sintassi
typedef struct _RPC_POLICY {
unsigned int Length;
unsigned long EndpointFlags;
unsigned long NICFlags;
} RPC_POLICY, *PRPC_POLICY;
Members
Length
Dimensioni della struttura RPC_POLICY , in byte. Il membro Length consente la compatibilità con le versioni future di questa struttura, che possono contenere campi aggiuntivi. Impostare sempre length uguale a sizeof(RPC_POLICY) quando si inizializza la struttura RPC_POLICY nel codice.
EndpointFlags
Set di flag che determinano gli attributi della porta o delle porte in cui il server riceve chiamate di routine remote. È possibile specificare più flag (usando l'operatore OR bit per bit) dal set di valori per una determinata sequenza di protocollo. Nella tabella seguente sono elencati i valori possibili per il membro EndpointFlags .
| Valore | Significato |
|---|---|
|
Specifica il valore predefinito del sistema. |
|
Alloca l'endpoint da una delle porte definite nel Registro di sistema come "Internet Available". Valido solo con sequenze di protocollo ncacn_ip_tcp e ncadg_ip_udp . |
|
Alloca l'endpoint da una delle porte definite nel Registro di sistema come "Intranet disponibile". Valido solo con sequenze di protocollo ncacn_ip_tcp e ncadg_ip_udp . |
|
La coda di ricezione del processo del server verrà eliminata automaticamente all'uscita del server RPC. Eventuali chiamate in sospeso ancora nella coda andranno perse. Questo è il valore predefinito. Valido solo con la sequenza di protocollo ncadg_mq . |
|
Specifica che la coda di ricezione del processo del server viene mantenuta dopo l'uscita del processo del server. Il valore predefinito è che la coda viene eliminata al termine del processo del server. Valido solo con ncadg_mq sequenza di protocollo. |
|
Se la coda di ricezione esiste già perché è stata aperta in precedenza come coda permanente, cancellare eventuali chiamate in sospeso in attesa nella coda. Valido solo con la sequenza di protocollo ncadg_mq. |
|
Se la coda di ricezione esiste già, non modificare le impostazioni esistenti per l'autenticazione o la crittografia. Valido solo con la sequenza di protocollo ncadg_mq. |
|
La coda di ricezione del processo server accetta solo le chiamate autenticate dai client. Il valore predefinito è che le chiamate autenticate e non autenticate vengono accettate. Valido solo con ncadg_mq sequenza di protocollo. |
|
Le chiamate al server vengono crittografate. Il valore predefinito è che vengono accettate sia le chiamate crittografate che non crittografate. Valido solo con ncadg_mq sequenza di protocollo. |
|
La coda di ricezione del server accetta tutte le chiamate dai client. Si tratta del livello di autenticazione predefinito. Valido solo con il protocollo ncadg_mq . |
|
Imposta la coda di ricezione del server in modo che accetti solo le chiamate client con livello di autenticazione RPC_C_AUTHN_LEVEL_PKT_INTEGRITY o RPC_C_AUTHN_LEVEL_PKT_PRIVACY. Valido solo con la sequenza di protocollo ncadg_mq. |
|
Imposta la coda di ricezione del server in modo che accetti solo le chiamate client con livello di autenticazione RPC_C_AUTHN_LEVEL_PKT_PRIVACY. Le chiamate con un livello di autenticazione inferiore vengono ignorate. Valido solo con la sequenza di protocollo ncadg_mq. |
Nota Se il Registro di sistema non contiene alcuna chiave che specifica i criteri predefiniti, il membro EndpointFlags non avrà alcun effetto in fase di esecuzione. Se una chiave manca o contiene un valore non valido, l'intera configurazione per il protocollo ( ncacn_ip_tcp, ncadg_ip_udp o ncadg_mq) viene contrassegnata come non valida e tutte le chiamate a RpcServerUseProtseq* funzioni su tale protocollo avranno esito negativo.
NICFlags
Criteri per l'associazione alle schede di interfaccia di rete. Nella tabella seguente sono elencati i valori possibili per il membro NICFlags .
| Valore | Significato |
|---|---|
|
Esegue il binding alle schede di interfaccia di rete in base alle impostazioni del Registro di sistema. Usare sempre questo valore quando si usa la struttura RPC_POLICY per definire le proprietà della coda di messaggi. |
|
Esegue l'override delle impostazioni del Registro di sistema e viene associato a tutte le schede di interfaccia di rete. Se la chiave bind non è presente nel Registro di sistema, il membro NICFlags non avrà alcun effetto in fase di esecuzione. Se la chiave contiene un valore non valido, l'intera configurazione viene contrassegnata come non valida e tutte le chiamate a RpcServerUseProtseq* avranno esito negativo. |
Commenti
È possibile usare la struttura RPC_Policy per impostare i criteri per le chiamate di routine remote in fase di esecuzione. Questi criteri includono:
- Accodamento messaggi: consente al server di specificare le proprietà di accodamento messaggi, ad esempio sicurezza, qualità del recapito e durata della coda del processo server. Questo criterio è valido solo per le chiamate remote sul trasporto di accodamento messaggi (ncadg_mq).
- Allocazione delle porte per le porte dinamiche: specifica se l'endpoint registrato da questa applicazione deve passare al set di porte disponibile per Internet o intranet.
- Associazione selettiva: consente ai computer multihomed di associare in modo selettivo le schede di interfaccia di rete.
Nota L'allocazione delle porte e i criteri di associazione selettiva sono validi solo per le chiamate remote su connessioni TCP ( ncacn_ip_tcp) e UDP ( ncadg_ip_udp). Per altre informazioni, vedere Configurazione del Registro di sistema per le allocazioni delle porte e l'associazione selettiva.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Intestazione | rpcdce.h (include Rpc.h) |
Vedi anche
Configurazione del Registro di sistema per le allocazioni delle porte e l'associazione selettiva