WcsEnumColorProfiles-Funktion (icm.h)

  • Artikel

Listet Farbprofile auf, die einem beliebigen Gerät im angegebenen Bereich zugeordnet sind.

Hinweis

Diese API unterstützt keine "erweiterten Farbprofile" für HDR-Monitore. Verwenden Sie ColorProfileGetDisplayList zum Verwalten erweiterter Farbprofile.

Syntax

BOOL WcsEnumColorProfiles(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PENUMTYPEW                   pEnumRecord,
  PBYTE                        pBuffer,
  DWORD                        dwSize,
  PDWORD                       pnProfiles
);

Parameter

scope

Ein WCS_PROFILE_MANAGEMENT_SCOPE Wert, der den Bereich dieses Profilverwaltungsvorgangs angibt.

pEnumRecord

Ein Zeiger auf eine Struktur, die die Enumerationskriterien angibt.

pBuffer

Ein Zeiger auf einen Puffer, in dem die Profilnamen aufgelistet werden sollen. Die WcsEnumColorProfiles-Funktion platziert in diesem Puffer eine MULTI_SZ Zeichenfolge, die aus Profilnamen besteht, die die in *pEnumRecord angegebenen Kriterien erfüllen.

dwSize

Eine Variable, die die Größe des Puffers in Bytes enthält, auf den pBuffer verweist. Siehe Hinweise.

pnProfiles

Ein optionaler Zeiger auf eine Variable, die die Anzahl der Profilnamen empfängt, die in den Puffer kopiert werden, auf den pBuffer zeigt. Kann NULL sein, wenn diese Informationen nicht benötigt werden.

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

Verwenden Sie die WcsEnumColorProfilesSize-Funktion , um den Wert für den dwSize-Parameter abzurufen, der die Größe des Puffers in Bytes entspricht, auf den der pBuffer-Parameter verweist.

Wenn der parameter profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE ist, werden nur systemweite Zuordnungen von Profilen zum Gerät berücksichtigt. Wenn profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER ist, werden nur Benutzerzuordnungen für den aktuellen Benutzer berücksichtigt. Wenn WcsSetUsePerUserProfiles noch nie für diesen Benutzer aufgerufen wurde oder wcsSetUsePerUserProfiles zuletzt für diesen Benutzer aufgerufen wurde, wobei der usePerUserProfiles-Parameter auf FALSE festgelegt ist, gibt WCSEnumColorProfiles eine leere Liste zurück.

Wenn WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER (die aktuelle Benutzereinstellung) vorhanden ist, überschreibt sie den systemweiten Standardwert für den parameter profileManagementScope .

Diese Funktion ist im LUA-Kontext (User Account) Least-Privileged 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

Weitere Informationen