IDeviceModelPlugIn::Initialize-Methode (wcsplugin.h)

Artikel
08/27/2023

Verwendet einen Zeiger auf einen Stream, der das gesamte Gerätemodell-Plug-In als Eingabe enthält, und initialisiert alle internen Parameter, die für das Plug-In erforderlich sind.

Syntax

HRESULT Initialize(
  [in] BSTR bstrXml,
  [in] UINT cNumModels,
  [in] UINT iModelPosition
);

Parameter

[in] bstrXml

Eine Zeichenfolge, die das Plug-In-Profil des BSTR-XML-Gerätemodells enthält. Dieser Parameter speichert Daten als Little-Endian-Unicode-XML. Es kann jedoch keine führenden Bytes enthalten, um sie als solche zu markieren. Außerdem spiegelt die Codierung Schlüsselwort (keyword) im XML möglicherweise nicht wider, dass dies als Little-Endian-Unicode formatiert ist. Darüber hinaus wird die BSTR-XML-Datei aufgrund der Aktion der MSXML-Engine verarbeitet und enthält möglicherweise nicht genau den gleichen Inhalt wie die ursprüngliche XML-Datei.

[in] cNumModels

Die Anzahl der Gesamtmodelle in der Transformationssequenz.

[in] iModelPosition

Die position des einbasierten Modells des anderen Gerätemodells im Workflow von uiNumModels , wie in der Initialize-Funktion angegeben.

Rückgabewert

Wenn diese Funktion erfolgreich ist, wird der Rückgabewert S_OK.

Wenn diese Funktion fehlschlägt, wird der Rückgabewert E_FAIL.

Hinweise

Wenn diese Funktion mehrmals aufgerufen wird, geben nachfolgende Aufrufe den zugeordneten Arbeitsspeicher frei und initialisieren gemäß dem neuen bstrXml-Parameter neu.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wcsplugin.h

Freigeben über