Compartir a través de

Función RpcNsBindingInqEntryNameA (rpcdce.h)

  • Artículo

La función RpcNsBindingInqEntryName devuelve el nombre de entrada del que vino 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 evitar que rpcNsBindingInqEntryName devuelva el parámetro entryName de . 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 de 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.
 

Observaciones

La función RpcNsBindingInqEntryName devuelve el nombre del nombre nombre de la entrada de base de datos del servicio del nombre a partir del cual 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 de . La aplicación es responsable de llamar a la función de RpcStringFree para desasignar esa memoria.

Un nombre de entrada solo se asocia con identificadores de enlace devueltos desde el RpcNsBindingImportNext, RpcNsBindingLookupNexty funciones RpcNsBindingSelect.

Si el identificador de enlace especificado en el parámetro binding no se devolvió desde una entrada de base de datos name-service (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 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de rpcdce.h (include Rpc.h)
biblioteca de Rpcrt4.lib
DLL de Rpcrt4.dll

Consulte también

rpcBindingFromStringBinding

RpcNsBindingImportNext

RpcNsBindingLookupNext

RpcNsBindingSelect

RpcStringFree