srv_pfieldex (API de procedimiento almacenado extendido)

Nota importanteImportante

Esta característica se quitará en una versión futura de Microsoft SQL Server. No utilice esta característica en nuevos trabajos de desarrollo y modifique lo antes posible las aplicaciones que actualmente la utilizan. En su lugar, use la integración CLR.

Devuelve un puntero a los datos que contienen el campo SRV_PROC solicitado.

Sintaxis


void *srv_pfieldex(SRV_PROC * 
srvproc
, int 
field
, int * 
len
);

Argumentos

  • srvproc
    Es un puntero a la estructura SRV_PROC que es el identificador de una conexión cliente determinada. La estructura contiene información que la biblioteca de API de procedimiento almacenado extendido usa para administrar la comunicación y los datos entre la aplicación y el cliente.

  • field
    Especifica el campo srvproc a devolver.

    Campo

    Descripción

    Tipo devuelto

    SRV_MSGLCID

    LCID de mensaje de la sesión actual.

    ULONG*

    SRV_INSTANCENAME

    Nombre de instancia (si tiene nombre); de lo contrario, devuelve NULL.

    WCHAR*

  • len
    Es un puntero a una variable int que contiene la longitud del valor de field devuelto en bytes. Si len es NULL, no se devuelve la longitud. Cuando se devuelve NULL *len está establecido en 0.

Devuelve

Un puntero a los datos cuyo tipo depende de field. Se devuelve NULL cuando len es NULL o srvproc es NULL. Si field es desconocido, se devuelve NULL. Cuando se devuelve NULL *len está establecido en 0.

Nota de seguridadNota de seguridad

El búfer que se devuelve desde el servidor debe ser de sólo lectura. Si no es así, es posible que el estado del servidor esté dañado.

Notas

Nota de seguridad   Debe revisar cuidadosamente el código fuente de los procedimientos almacenados extendidos y probar las DLL compiladas antes de instalarlas en un servidor de producción. Para obtener información acerca de la revisión y pruebas de seguridad, vea este sitio web de Microsoft.