CM_Get_Device_Interface_AliasW-Funktion (cfgmgr32.h)

  • Artikel

Die CM_Get_Device_Interface_Alias-Funktion gibt den Alias der angegebenen Geräteschnittstelle instance zurück, wenn der Alias vorhanden ist.

Syntax

CMAPI CONFIGRET CM_Get_Device_Interface_AliasW(
  [in]      LPCWSTR pszDeviceInterface,
  [in]      LPGUID  AliasInterfaceGuid,
  [out]     LPWSTR  pszAliasDeviceInterface,
  [in, out] PULONG  pulLength,
  [in]      ULONG   ulFlags
);

Parameter

[in] pszDeviceInterface

Zeiger auf den Namen der Geräteschnittstelle instance, für die ein Alias abgerufen werden soll. Der Aufrufer hat diese Zeichenfolge in der Regel von einem Aufruf an CM_Get_Device_Interface_List oder in einer PnP-Benachrichtigungsstruktur erhalten.

[in] AliasInterfaceGuid

Zeiger auf eine GUID, die die Schnittstellenklasse des abzurufenden Alias angibt.

[out] pszAliasDeviceInterface

Gibt einen Zeiger auf einen Puffer an, der bei erfolgreicher Rückgabe auf eine Zeichenfolge zeigt, die den Namen des Alias enthält. Der Aufrufer muss diese Zeichenfolge freigeben, wenn sie nicht mehr benötigt wird.

Ein Puffer ist erforderlich. Andernfalls schlägt der Aufruf fehl.

[in, out] pulLength

Gibt die Anzahl der Zeichen in pszAliasDeviceInterface an und empfängt die Anzahl der Zeichen, die zum Speichern der Aliasgeräteschnittstelle erforderlich sind.

Bei der Eingabe muss dieser Parameter größer als 0 sein.

[in] ulFlags

Reserviert. Darf nicht verwendet werden.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird einer der CR_-Präfix-Fehlercodes zurückgegeben, die in Cfgmgr32.h definiert sind.

Rückgabecode Beschreibung
CR_NO_SUCH_DEVICE_INTERFACE
 Gibt möglicherweise an, dass kein Alias der angegebenen Schnittstellenklasse vorhanden ist.
CR_OUT_OF_MEMORY
 Es steht nicht genügend Arbeitsspeicher zur Verfügung, um den Vorgang durchzuführen.
CR_BUFFER_SMALL
 Der übergebene Puffer ist zu klein.

Hinweise

Geräteschnittstellen werden als Aliase betrachtet, wenn sie vom gleichen zugrunde liegenden Gerät verfügbar gemacht werden und identische Schnittstellenreferenzzeichenfolgen aufweisen, aber unterschiedliche Schnittstellenklassen aufweisen.

Der Parameter pszDeviceInterface gibt eine Geräteschnittstelle instance für ein bestimmtes Gerät an, das zu einer bestimmten Schnittstellenklasse gehört, mit einer bestimmten Verweiszeichenfolge. CM_Get_Device_Interface_Alias gibt eine andere Geräteschnittstelle instance für dieselbe Geräte- und Verweiszeichenfolge zurück, jedoch einer anderen Schnittstellenklasse, sofern vorhanden.

Beispielsweise könnte der Funktionstreiber für ein fehlertolerantes Volume zwei Geräteschnittstellen registrieren und festlegen, eine der Schnittstellenklasse fehlertolerant-volume und eine der Volumeschnittstellenklasse. Ein anderer Treiber könnte CM_Get_Device_Interface_Alias mit dem symbolischen Link für eine der Schnittstellen aufrufen und fragen, ob die andere Schnittstelle vorhanden ist, indem er seine Schnittstellenklasse angibt.

Zwei Geräteschnittstellen mit NULL-Verweiszeichenfolgen sind Aliase, wenn sie vom gleichen zugrunde liegenden Gerät verfügbar gemacht werden und unterschiedliche Schnittstellenklassen-GUIDs aufweisen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform Desktop
Kopfzeile cfgmgr32.h (einschließlich Cfgmgr32.h)
Bibliothek Cfgmgr32.lib