Freigeben über

  • Artikel

srv_pfieldex (API für erweiterte gespeicherte Prozeduren)

Wichtiger HinweisWichtig

Diese Funktion wird in zukünftigen Versionen von Microsoft SQL Server nicht mehr bereitgestellt. Verwenden Sie diese Funktion beim Entwickeln neuer Anwendungen nicht, und planen Sie so bald wie möglich das Ändern von Anwendungen, in denen es zurzeit verwendet wird. Verwenden Sie stattdessen die CLR-Integration.

Gibt einen Zeiger auf Daten zurück, die das angeforderte SRV_PROC-Feld enthalten.

Syntax


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

Argumente

  • srvproc
    Ein Zeiger auf die SRV_PROC-Struktur, die das Handle für eine bestimmte Clientverbindung ist. Die Struktur enthält Informationen, mit der die API-Bibliothek für erweiterte gespeicherte Prozeduren die Daten und Kommunikation zwischen der Anwendung und dem Client verwaltet.

  • field
    Gibt das zurückzugebende srvproc-Feld an.

    Feld

    Beschreibung

    Rückgabetyp

    SRV_MSGLCID

    Aktuelle Sitzungsmeldung-LCID

    ULONG*

    SRV_INSTANCENAME

    Instanzname (wenn genannt); gibt andernfalls NULL zurück

    WCHAR*

  • len
    Ist ein Zeiger auf eine int-Variable, die die Länge des zurückgegebenen field-Werts in Byte enthält. Wenn len NULL ist, wird die Länge nicht zurückgegeben. Wenn NULL zurückgegeben wird, wird *len auf 0 gesetzt.

Rückgabewert

Ein Zeiger auf Daten, deren Typ von field abhängt. NULL wird zurückgegeben, wenn len NULL ist oder wenn srvproc NULL ist. Ist field unbekannt, wird NULL zurückgegeben. Wenn NULL zurückgegeben wird, wird *len auf 0 gesetzt.

SicherheitshinweisSicherheitshinweis

Der vom Server zurückgegebene Puffer sollte schreibgeschützt sein. Andernfalls ist der Serverstatus möglicherweise beschädigt.

Hinweise

Sicherheitshinweis   Sie sollten den Quellcode der erweiterten gespeicherten Prozeduren gründlich überprüfen. Außerdem sollten Sie die kompilierten DLLs vor der Installation auf einem Produktionsserver testen. Weitere Informationen zum Überprüfen und Testen der Sicherheit finden Sie auf dieser Microsoft-Website.