CM_Get_Device_Interface_AliasA-Funktion (cfgmgr32.h)

Artikel
02/23/2024

Die funktion CM_Get_Device_Interface_Alias gibt den Alias der angegebenen Geräteschnittstelle instance zurück, sofern der Alias vorhanden ist.

Syntax

CMAPI CONFIGRET CM_Get_Device_Interface_AliasA(
  [in]      LPCSTR pszDeviceInterface,
  [in]      LPGUID AliasInterfaceGuid,
  [out]     LPSTR  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 empfangen.

[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 verweist, 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 in Cfgmgr32.h definierten Fehlercodes mit CR_ Präfix zurückgegeben.

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 dasselbe Gerät und die gleiche 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 für fehlertolerante Volumes 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 (include Cfgmgr32.h)
Bibliothek	Cfgmgr32.lib

Freigeben über