GetColorDirectoryA-Funktion (icm.h)
Hinweis
Diese API ist in zukünftigen Releases 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 EnumColorProfilesA |
| Installieren/Deinstallieren von Farbprofilen | Verwenden von InstallColorProfileA/UninstallColorProfileA |
| Direktes Öffnen einer Farbprofildatei | Verwenden Sie OpenColorProfileA mit dwType=PROFILE_FILENAME im PROFILE-Strukturparameter. Oder verwenden Sie WcsOpenColorProfileA. Icm.h enthält viele APIs, die die zurückgegebenen HPROFILE für die Farbprofilbearbeitung akzeptieren. |
Ruft den Pfad des Windows COLOR-Verzeichnisses auf einem angegebenen Computer ab.
Syntax
BOOL GetColorDirectoryA(
PCSTR pMachineName,
PSTR 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
Zeigt auf eine Variable, die die Größe des Puffers in Bytes 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.
Bemerkungen
Unterstützung pro Benutzer/LUA
Das Farbverzeichnis ist weiterhin systemweit. Diese Funktion ist im LUA-Kontext ausführbar.
Anforderungen
| 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 |