GetColorDirectoryW-Funktion (icm.h)

Artikel
02/29/2024

Hinweis

Diese API ist in zukünftigen Versionen möglicherweise nicht verfügbar. Wir empfehlen neue und vorhandene Software, andere APIs für Farbprofilinteraktionen zu verwenden. Einige Beispiele finden Sie in der folgenden Tabelle.

Szenario	Mechanismus
Auflisten aller installierten Profile	Verwenden von WcsEnumColorProfilesSize und WcsEnumColorProfiles oder EnumColorProfilesW
Installieren/Deinstallieren von Farbprofilen	Verwenden von InstallColorProfileW/UninstallColorProfileW
Direktes Öffnen einer Farbprofildatei	Verwenden Sie OpenColorProfileW mit dwType=PROFILE_FILENAME im PROFILE-Strukturparameter. Oder verwenden Sie WcsOpenColorProfileW. Icm.h enthält viele APIs, die das zurückgegebene HPROFILE für die Farbprofilbearbeitung akzeptieren.

Ruft den Pfad des Windows COLOR-Verzeichnisses auf einem angegebenen Computer ab.

Syntax

BOOL GetColorDirectoryW(
  PCWSTR pMachineName,
  PWSTR  pBuffer,
  PDWORD pdwSize
);

Parameter

pMachineName

Reserviert; muss NULL sein. Dieser Parameter soll auf den Namen des Computers verweisen, auf dem das Profil installiert werden soll. Ein NULL-Zeiger gibt den lokalen Computer an.

pBuffer

Zeigt auf den Puffer, in dem der Farbverzeichnispfad platziert werden soll.

pdwSize

Verweist auf eine Variable, die die Größe des Puffers in Byte enthält, auf den pBuffer verweist. Bei der Rückgabe enthält die Variable die Größe des tatsächlich verwendeten oder benötigten Puffers.

Rückgabewert

Wenn diese Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn diese Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Hinweise

Pro Benutzer/LUA-Unterstützung

Das Farbverzeichnis ist immer noch systemweit. Diese Funktion ist im LUA-Kontext ausführbar.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	icm.h
Bibliothek	Mscms.lib
DLL	Mscms.dll

Freigeben über