GetStandardColorSpaceProfileW-Funktion (icm.h)
Ruft das Farbprofil ab, das für den angegebenen Standardfarbraum registriert ist.
Syntax
BOOL GetStandardColorSpaceProfileW(
PCWSTR pMachineName,
DWORD dwSCS,
PWSTR pBuffer,
PDWORD pcbSize
);
Parameter
pMachineName
Reserviert. Muss NULL sein. Dieser Parameter soll auf den Namen des Computers verweisen, auf dem ein Standardfarbraumprofil abgerufen werden soll. Ein NULL-Zeiger gibt den lokalen Computer an.
dwSCS
Gibt den ID-Wert des Standardfarbraums an, für den das Profil abgerufen werden soll. Die einzigen gültigen Werte für diesen Parameter sind LCS_sRGB und LCS_WINDOWS_COLOR_SPACE.
pBuffer
Zeiger auf den Puffer, in dem der Name des Profils platziert werden soll. Wenn NULL, gibt der Aufruf TRUE zurück, und die erforderliche Größe des Puffers wird in pdwSize platziert.
pcbSize
Zeiger auf eine Variable, die die Größe des Puffers in Byte enthält, auf den pProfileName 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
Wenn der Puffer, auf den pProfileName verweist, von einer Anwendung dynamisch zugeordnet werden soll, kann die Anwendung die GetStandardColorSpaceProfile-Funktion aufrufen, um die für den Puffer erforderliche Größe abzurufen. Wenn GetStandardColorSpaceProfile aufgerufen wird, wobei pProfileName auf NULL festgelegt ist, wird FALSE zurückgegeben, und das DWORD , auf das von pdwSize verwiesen wird, enthält die Anzahl der Bytes, die für den Puffer benötigt werden, auf den pProfileName verweist. Die Anwendung kann dann den Puffer zuordnen und GetStandardColorSpaceProfile erneut aufrufen, wobei pProfileName auf die Adresse des Puffers festgelegt ist.
Diese Funktion unterstützt zusätzlich zu ICC-Profilen (International Color Consortium) auch WcS-Gerätemodellprofile (Windows Color System). Es unterstützt keine WCS CAMP- oder GMMP-Profile und gibt einen Fehler zurück, wenn solche Profile verwendet werden.
Übersicht über die spezifischen Funktionen von Windows Vista
Dadurch werden wcs-DMPs zusätzlich zu ICC-Profilen unterstützt. Es unterstützt keine WCS CAMP- oder GMMP-Profile und gibt einen Fehler zurück, wenn solche Profile mit dieser API verwendet werden.
Pro Benutzer/LUA-Unterstützung
Dadurch wird das Farbprofil abgerufen, das für den angegebenen Standardfarbraum für den aktuellen Benutzer registriert ist. Wenn keine solche Einstellung für den aktuellen Benutzer vorhanden ist, wird die systemweite Einstellung abgerufen.
Dabei wird WcsGetDefaultColorProfile mit WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER verwendet.
Dies 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 |