Freigeben über

Einstiegspunkt für VirtualChannelGetInstance

  • Artikel

Wird aufgerufen, damit das Plug-In eine instance der IWTSPlugin-Schnittstelle für alle Plug-Ins erstellt, die von der DLL implementiert werden.

Hinweis

Diese Funktion wird vom Plug-In implementiert und muss anhand des Namens exportiert werden, sodass eine Anwendung die Funktionen LoadLibrary und GetProcAddress zum dynamischen Verknüpfen mit der Funktion verwenden kann.

Der Prototyp für diese Funktion ist in keiner öffentlichen Headerdatei enthalten, daher müssen Sie ihn genau wie gezeigt deklarieren.

Syntax

HRESULT VCAPITYPE VirtualChannelGetInstance(
  _In_    REFIID refiid,
  _Inout_ ULONG  *pNumObjs,
  _Out_   VOID   **ppObjArray
);

Parameter

refiid [in]

Gibt den Typ der zurückzugebenden Schnittstelle an. Dies muss IID_IWTSPlugin sein.

pNumObjs [in, out]

Die Adresse einer ULONG-Variablen , die die Anzahl der abgerufenen Schnittstellen empfängt.

ppObjArray [out]

Die Adresse eines Arrays von Zeigern, das die Schnittstellenzeiger empfängt. Wenn dieser Parameter NULL ist, muss die Implementierung die Anzahl der von der DLL implementierten Plug-Ins im pNumObjs-Parameter einfügen. Dadurch kann der Aufrufer die richtige Größe des Arrays für ppObjArray zuordnen.

Rückgabewert

Wenn dieser Einstiegspunkt erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows Vista
Unterstützte Mindestversion (Server)
 WindowsServer 2008