XcvOpenPort-Funktion (winsplp.h)

Artikel
02/27/2024

Die XcvOpenPort-Funktion einer Portmonitorserver-DLL öffnet einen Port für Konfigurationsvorgänge.

Syntax

BOOL XcvOpenPort(
  LPCWSTR     pszObject,
  ACCESS_MASK GrantedAccess,
  PHANDLE     phXcv
);

Parameter

pszObject

Vom Aufrufer bereitgestellter Zeiger auf eine Zeichenfolge, die den Namen des Ports darstellt. Kann NULL sein, und die meisten Monitore benötigen diesen Parameter nicht.

GrantedAccess

Vom Aufrufer bereitgestellte ACCESS_MASK-Struktur, die den Zugriff enthält, der dem Benutzer während des Aufrufs der OpenPrinter-Funktion der Druckmonitor-UI-DLL gewährt wurde. Weitere Informationen finden Sie im abschnitt "Hinweise".

phXcv

Vom Aufrufer bereitgestellter Zeiger auf einen Ort, an dem ein von der Funktion bereitgestelltes Porthandle empfangen werden soll.

Rückgabewert

Wenn der Vorgang erfolgreich ist, sollte die Funktion TRUE zurückgeben. Andernfalls sollte FALSE zurückgegeben werden.

Hinweise

Portmonitorserver-DLLs sind erforderlich, um eine XcvOpenPort-Funktion zu definieren und deren Adresse in eine MONITOR2-Struktur einzuschließen.

Die OpenPrinter-Funktion des Spoolers (in der Microsoft Windows SDK Dokumentation beschrieben) ruft XcvOpenPort auf, wenn der angegebene Druckername eine der Zeichenfolgen "XcvPort" oder "XcvMonitor" enthält. Weitere Informationen finden Sie unter AddPortUI.

Die XcvOpenPort-Funktion sollte den Port zu Konfigurationszwecken öffnen. Dieser Vorgang besteht möglicherweise nur aus dem Speichern der Eingabeargumente zur späteren Verwendung in XcvDataPort. Die Funktion sollte ein Handle für die gespeicherten Informationen an der Position zurückgeben, auf die von phXcv verwiesen wird. Dieses Handle wird an den Aufrufer von OpenPrinter zurückgegeben und anschließend als Eingabeargument für XcvDataPort empfangen.

Die Funktion sollte die Maske für den gewährten Zugriff speichern. Später, wenn die XcvDataPort-Funktion der Server-DLL aufgerufen wird, sollte der gewährte Zugriff mit SERVER_ACCESS_ADMINISTER verglichen werden, und wenn der Vergleich fehlschlägt, sollte XcvDataPort ERROR_ACCESS_DENIED zurückgeben.