RpcBindingCreateW, fonction (rpcdce.h)
La fonction RpcBindingCreate crée un handle de liaison RPC rapide basé sur un modèle fourni.
Syntaxe
RPC_STATUS RpcBindingCreateW(
[in] RPC_BINDING_HANDLE_TEMPLATE_V1_W *Template,
[in, optional] RPC_BINDING_HANDLE_SECURITY_V1_W *Security,
[in, optional] RPC_BINDING_HANDLE_OPTIONS_V1 *Options,
[out] RPC_BINDING_HANDLE *Binding
);
Paramètres
[in] Template
RPC_BINDING_HANDLE_TEMPLATE structure qui décrit le handle de liaison à créer par cet appel. Ces données peuvent être remplacées pendant l’appel, de sorte que l’API ne conserve pas de référence à ces données. L’appelant doit libérer la mémoire utilisée par cette structure lorsque l’API retourne.
[in, optional] Security
RPC_BINDING_HANDLE_SECURITY structure qui décrit les options de sécurité de ce handle de liaison. Ces données peuvent être remplacées pendant l’appel, de sorte que l’API ne conserve pas de référence à ces données. L’appelant doit libérer la mémoire utilisée par cette structure lorsque l’API retourne.
Ce paramètre est facultatif. Si ce paramètre est défini sur NULL, les paramètres de sécurité par défaut pour RPC_BINDING_HANDLE_SECURITY seront utilisés.
[in, optional] Options
RPC_BINDING_HANDLE_OPTIONS structure qui décrit des options supplémentaires pour le handle de liaison. Ces données peuvent être remplacées pendant l’appel, de sorte que l’API ne conserve pas de référence à ces données. L’appelant doit libérer la mémoire utilisée par cette structure lorsque l’API retourne.
Ce paramètre est facultatif. Si ce paramètre est défini sur NULL, les options par défaut pour RPC_BINDING_HANDLE_OPTIONS seront utilisées.
[out] Binding
RPC_BINDING_HANDLE structure qui contient le handle de liaison nouvellement créé. Si cette fonction n’a pas retourné RPC_S_OK, le contenu de cette structure n’est pas défini. Pour les appels RPC non locaux, ce handle doit être passé à RpcBindingBind.
Valeur de retour
Cette fonction retourne RPC_S_OK en cas de réussite ; sinon, un code d’erreur RPC_S_* est retourné. Pour plus d’informations sur ces codes d’erreur, consultez valeurs de retour RPC.
| Retourner le code | Description |
|---|---|
|
Le handle de liaison a été créé avec succès. |
|
Une fonctionnalité obsolète de RPC a été demandée pour ce handle de liaison.
Remarque Les seules séquences de protocole prises en charge pour cette API sont ncalrpc; Le choix d’une autre séquence de protocole entraîne le retour de ce code d’état d’erreur.
|
Remarques
Le handle de liaison RPC retourné par cette API peut être utilisé avec toutes les autres fonctions qui acceptent un handle de liaison en tant que paramètre.
Toutefois, avant que des appels ne puissent être effectués sur le handle de liaison, RpcBindingBind doivent être appelés pour rendre le handle de liaison disponible pour les appels distants. L’API RpcBindingCreate ne touche pas le réseau ni tente de communiquer avec le serveur RPC. Il crée simplement une structure de données interne basée sur les valeurs fournies dans le modèle. Un retour réussi n’indique pas que le serveur RPC est disponible, accessible ou spécifié correctement.
Note
L’en-tête rpcdce.h définit RpcBindingCreate comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista [applications de bureau | Applications UWP] |
| serveur minimum pris en charge | Windows Server 2008 [applications de bureau | Applications UWP] |
| plateforme cible | Windows |
| d’en-tête | rpcdce.h (inclure Rpc.h) |
| bibliothèque | Rpcrt4.lib |
| DLL | Rpcrt4.dll |