Función RpcNsBindingInqEntryNameA (rpcdce.h)

  • Artículo

La función RpcNsBindingInqEntryName devuelve el nombre de entrada del que procede el identificador de enlace.

Nota Esta función no se admite en Windows Vista ni en sistemas operativos posteriores.
 

Sintaxis

RPC_STATUS RpcNsBindingInqEntryNameA(
  RPC_BINDING_HANDLE Binding,
  unsigned long      EntryNameSyntax,
  RPC_CSTR           *EntryName
);

Parámetros

Binding

Identificador de enlace cuyo nombre de entrada de base de datos de servicio de nombres se devuelve.

EntryNameSyntax

Sintaxis usada en EntryName.

Para usar la sintaxis especificada en la entrada de valor del Registro

HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, proporcione un valor de RPC_C_NS_SYNTAX_DEFAULT.

EntryName

Devuelve la dirección de un puntero al nombre de la entrada de base de datos name-service en la que se encontró Binding .

Especifique un valor NULL para impedir que RpcNsBindingInqEntryName devuelva el parámetro EntryName . En este caso, la aplicación no llama a la función RpcStringFree .

Valor devuelto

Valor Significado
RPC_S_OK
 La llamada se realizó correctamente.
RPC_S_INVALID_BINDING
 El identificador de enlace no era válido.
RPC_S_NO_ENTRY_NAME
 No hay ningún nombre de entrada para el enlace.
RPC_S_INVALID_NAME_SYNTAX
 La sintaxis del nombre no es válida.
RPC_S_UNSUPPORTED_NAME_SYNTAX
 No se admite la sintaxis de nombre.
RPC_S_INCOMPLETE_NAME
 El nombre está incompleto.
 
Nota Para obtener una lista de códigos de error válidos, vea Rpc Return Values.
 

Comentarios

La función RpcNsBindingInqEntryName devuelve el nombre del nombre de entrada de base de datos de servicio de nombre del que vino un identificador de enlace compatible con el cliente.

La biblioteca en tiempo de ejecución rpc asigna memoria para la cadena devuelta en el parámetro EntryName . La aplicación es responsable de llamar a la función RpcStringFree para desasignar esa memoria.

Un nombre de entrada solo está asociado con los identificadores de enlace devueltos desde las funciones RpcNsBindingImportNext, RpcNsBindingLookupNext y RpcNsBindingSelect .

Si el identificador de enlace especificado en el parámetro Binding no se devolvió desde una entrada de base de datos de nombre-servicio (por ejemplo, si el identificador de enlace se creó llamando a RpcBindingFromStringBinding), RpcNsBindingInqEntryName devuelve una cadena vacía ("\0") y un código de estado de RPC_S_NO_ENTRY_NAME.

Nota

El encabezado rpcdce.h define RpcNsBindingInqEntryName como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado rpcdce.h (include Rpc.h)
Library Rpcrt4.lib
Archivo DLL Rpcrt4.dll

Consulte también

RpcBindingFromStringBinding

RpcNsBindingImportNext

RpcNsBindingLookupNext

RpcNsBindingSelect

RpcStringFree