Función RpcNsBindingInqEntryName (rpcdce.h)

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 RpcNsBindingInqEntryName(
  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.

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