Globale Registrierungs- und TypeLib-Funktionen

  • Artikel

Diese Funktionen unterstützen das Laden und Registrieren einer Typbibliothek.

Wichtig

Die in den folgenden Tabellen aufgeführten Funktionen können nicht in Anwendungen verwendet werden, die in der Windows-Runtime ausgeführt werden.

Name Beschreibung
AfxRegCreateKey Erstellt den angegebenen Registrierungsschlüssel.
AfxRegDeleteKey Löscht den angegebenen Registrierungsschlüssel.
AfxRegisterPreviewHandler Ein Hilfsprogramm zum Registrieren eines Vorschauhandlers.
AfxUnregisterPreviewHandler Ein Hilfsprogramm zum Aufheben der Registrierung eines Vorschauhandlers.
AtlRegisterTypeLib Diese Funktion wird aufgerufen, um eine Typbibliothek zu registrieren.
AtlUnRegisterTypeLib Diese Funktion wird aufgerufen, um die Registrierung einer Typbibliothek aufzuheben.
AfxRegOpenKey Öffnet den angegebenen Registrierungsschlüssel.
AfxRegOpenKeyEx Öffnet den angegebenen Registrierungsschlüssel.
AtlLoadTypeLib Mit dieser Funktion wird eine Typbibliothek geladen.
AtlUpdateRegistryFromResourceD Mit dieser Funktion können Sie die Registrierung von der angegebenen Ressource aus aktualisieren.
RegistryDataExchange Mit dieser Funktion können Sie Lese- und Schreibvorgänge in der Systemregistrierung vornehmen. Wird von den Registrierungsdatenaustauschmakros aufgerufen.

Diese Funktionen steuern, welchen Knoten in der Registrierung das Programm zum Speichern von Informationen verwendet.

Name Beschreibung
AtlGetPerUserRegistration Ruft ab, ob die Anwendung den Registrierungszugriff auf den Knoten HKEY_CURRENT_USER ( HKCU) umleitet.
AtlSetPerUserRegistration Legt fest, ob die Anwendung den Registrierungszugriff auf den Knoten HKEY_CURRENT_USER ( HKCU) umleitet.

Anforderungen

Kopfzeile: atlbase.h

AtlGetPerUserRegistration

Verwenden Sie diese Funktion, um zu bestimmen, ob die Anwendung den Registrierungszugriff auf den Knoten HKEY_CURRENT_USER (HKCU) umleitet.

Syntax

ATLINLINE ATLAPI AtlGetPerUserRegistration(bool* pEnabled);

Parameter

pEnabled
[out] TRUE gibt an, dass die Registrierungsinformationen an den HKCU-Knoten weitergeleitet werden; FALSE gibt an, dass die Anwendung Registrierungsinformationen in den Standardknoten schreibt. Der Standardknoten ist HKEY_CLASSES_ROOT (HKCR).

Rückgabewert

S_OK, wenn die Methode erfolgreich ist, andernfalls der HRESULT-Fehlercode, wenn ein Fehler auftritt.

Hinweise

Die Registrierungsumleitung ist standardmäßig nicht aktiviert. Wenn Sie diese Option aktivieren, wird der Registrierungszugriff auf HKEY_CURRENT_USER\Software\Classes umgeleitet.

Die Umleitung ist nicht global. Nur die MFC- und ATL-Frameworks sind von dieser Registrierungsumleitung betroffen.

Anforderungen

Kopfzeile: atlbase.h

AfxRegCreateKey

Erstellt den angegebenen Registrierungsschlüssel.

Syntax

LONG AFXAPI AfxRegCreateKey(HKEY hKey, LPCTSTR lpSubKey, PHKEY phkResult, CAtlTransactionManager* pTM = NULL);

Parameter

hKey
Ein Handle zu einem geöffneten Registrierungsschlüssel.

lpSubKey
Der Name eines Schlüssels, den diese Funktion öffnet oder erstellt.

phkResult
Ein Zeiger auf eine Variable, die ein Handle für den geöffneten oder erstellten Schlüssel empfängt.

pTM
Zeiger auf ein CAtlTransactionManager Objekt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ERROR_SUCCESS. Wenn die Funktion fehlschlägt, ist der Rückgabewert ein nichtzero-Fehlercode, der in Winerror.h definiert ist.

Anforderungen

Header: „afxpriv.h“

AfxRegDeleteKey

Löscht den angegebenen Registrierungsschlüssel.

Syntax

LONG AFXAPI AfxRegDeleteKey(HKEY hKey, LPCTSTR lpSubKey, CAtlTransactionManager* pTM = NULL);

Parameter

hKey
Ein Handle zu einem geöffneten Registrierungsschlüssel.

lpSubKey
Der Name des zu löschenden Schlüssels.

pTM
Zeiger auf ein CAtlTransactionManager Objekt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ERROR_SUCCESS. Wenn die Funktion fehlschlägt, ist der Rückgabewert ein nichtzero-Fehlercode, der in Winerror.h definiert ist.

Anforderungen

Header: „afxpriv.h“

Ein Hilfsprogramm zum Registrieren eines Vorschauhandlers.

Syntax

BOOL AFXAPI AfxRegisterPreviewHandler(LPCTSTR lpszCLSID, LPCTSTR lpszShortTypeName, LPCTSTR lpszFilterExt);

Parameter

lpszCLSID
Gibt die CLSID des Handlers an.

lpszShortTypeName
Gibt die ProgID des Handlers an.

lpszFilterExt
Gibt die dateierweiterung an, die mit diesem Handler registriert ist.

Anforderungen

Header: afxdisp.h

AtlRegisterTypeLib

Diese Funktion wird aufgerufen, um eine Typbibliothek zu registrieren.

ATLAPI AtlRegisterTypeLib(HINSTANCE hInstTypeLib, LPCOLESTR lpszIndex);

Parameter

hInstTypeLib
Das Handle für die Modulinstanz.

lpszIndex
Zeichenfolge im Format "\\N", wobei N der ganzzahlige Index der Typbibliotheksressource ist. Kann NULL sein, wenn kein Index erforderlich ist.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

Hinweise

Diese Hilfsfunktion wird von AtlComModuleUnregisterServer und CAtlComModule::RegisterTypeLib verwendet.

Anforderungen

Kopfzeile: atlbase.h

AfxRegOpenKey

Öffnet den angegebenen Registrierungsschlüssel.

Syntax

LONG AFXAPI AfxRegOpenKey(HKEY hKey, LPCTSTR lpSubKey, PHKEY phkResult, CAtlTransactionManager* pTM = NULL);

Parameter

hKey
Ein Handle zu einem geöffneten Registrierungsschlüssel.

lpSubKey
Der Name eines Schlüssels, den diese Funktion öffnet oder erstellt.

phkResult
Ein Zeiger auf eine Variable, die ein Handle für den erstellten Schlüssel empfängt.

pTM
Zeiger auf ein CAtlTransactionManager Objekt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ERROR_SUCCESS. Wenn die Funktion fehlschlägt, ist der Rückgabewert ein nichtzero-Fehlercode, der in Winerror.h definiert ist.

Anforderungen

Header: „afxpriv.h“

AfxRegOpenKeyEx

Öffnet den angegebenen Registrierungsschlüssel.

Syntax

LONG AFXAPI AfxRegOpenKeyEx(HKEY hKey, LPCTSTR lpSubKey, DWORD ulOptions, REGSAM samDesired, PHKEY phkResult, CAtlTransactionManager* pTM = NULL);

Parameter

hKey
Ein Handle zu einem geöffneten Registrierungsschlüssel.

lpSubKey
Der Name eines Schlüssels, den diese Funktion öffnet oder erstellt.

ulOptions
Dieser Parameter ist reserviert und muss null sein.

samDesired
Eine Maske, die die gewünschten Zugriffsrechte für den Schlüssel angibt.

phkResult
Ein Zeiger auf eine Variable, die ein Handle für den geöffneten Schlüssel empfängt.

pTM
Zeiger auf ein CAtlTransactionManager Objekt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ERROR_SUCCESS. Wenn die Funktion fehlschlägt, ist der Rückgabewert ein nichtzero-Fehlercode, der in Winerror.h definiert ist.

Anforderungen

Header: „afxpriv.h“

AfxUnregisterPreviewHandler

Ein Hilfsprogramm zum Aufheben der Registrierung eines Vorschauhandlers.

Syntax

BOOL AFXAPI AfxUnRegisterPreviewHandler(LPCTSTR lpszCLSID);

Parameter

lpszCLSID
Gibt die CLSID des Handlers an, der nicht registriert werden soll.

Anforderungen

Header: afxdisp.h

AtlSetPerUserRegistration

Legt fest, ob die Anwendung den Registrierungszugriff auf den Knoten HKEY_CURRENT_USER (HKCU) umleitet.

Syntax

ATLINLINE ATLAPI AtlSetPerUserRegistration(bool bEnable);

Parameter

bEnable
[in] TRUE gibt an, dass die Registrierungsinformationen an den HKCU-Knoten weitergeleitet werden; FALSE gibt an, dass die Anwendung Registrierungsinformationen in den Standardknoten schreibt. Der Standardknoten ist HKEY_CLASSES_ROOT (HKCR).

Rückgabewert

S_OK, wenn die Methode erfolgreich ist, andernfalls der HRESULT-Fehlercode, wenn ein Fehler auftritt.

Hinweise

Die Registrierungsumleitung ist standardmäßig nicht aktiviert. Wenn Sie diese Option aktivieren, wird der Registrierungszugriff auf HKEY_CURRENT_USER\Software\Classes umgeleitet.

Die Umleitung ist nicht global. Nur die MFC- und ATL-Frameworks sind von dieser Registrierungsumleitung betroffen.

Anforderungen

Kopfzeile: atlbase.h

AtlUnRegisterTypeLib

Diese Funktion wird aufgerufen, um die Registrierung einer Typbibliothek aufzuheben.

Syntax

ATLAPI AtlUnRegisterTypeLib(
    HINSTANCE hInstTypeLib,
    LPCOLESTR lpszIndex);

Parameter

hInstTypeLib
Das Handle für die Modulinstanz.

lpszIndex
Zeichenfolge im Format "\\N", wobei N der ganzzahlige Index der Typbibliotheksressource ist. Kann NULL sein, wenn kein Index erforderlich ist.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

Hinweise

Diese Hilfsfunktion wird von CAtlComModule::UnRegisterTypeLib und AtlComModuleUnregisterServer verwendet.

Anforderungen

Kopfzeile: atlbase.h

AtlLoadTypeLib

Mit dieser Funktion wird eine Typbibliothek geladen.

Syntax

ATLINLINE ATLAPI AtlLoadTypeLib(
    HINSTANCE hInstTypeLib,
    LPCOLESTR lpszIndex,
    BSTR* pbstrPath,
    ITypeLib** ppTypeLib);

Parameter

hInstTypeLib
Behandeln Des Moduls, das der Typbibliothek zugeordnet ist.

lpszIndex
Zeichenfolge im Format "\\N", wobei N der ganzzahlige Index der Typbibliotheksressource ist. Kann NULL sein, wenn kein Index erforderlich ist.

pbstrPath
Enthält bei erfolgreicher Rückgabe den vollständigen Pfad des Moduls, das der Typbibliothek zugeordnet ist.

ppTypeLib
Enthält bei erfolgreicher Rückgabe einen Zeiger auf einen Zeiger auf die geladene Typbibliothek.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

Hinweise

Diese Hilfsfunktion wird von AtlRegisterTypeLib und AtlUnRegisterTypeLib verwendet.

AtlUpdateRegistryFromResourceD

Diese Funktion war in Visual Studio 2013 veraltet und wird in Visual Studio 2015 entfernt.

<removed>

RegistryDataExchange

Mit dieser Funktion können Sie Lese- und Schreibvorgänge in der Systemregistrierung vornehmen.

Syntax

HRESULT RegistryDataExchange(
    T* pT,
    enum RDXOperations rdxOp,
    void* pItem = NULL);

Parameter

Pt
Ein Zeiger auf das aktuelle Objekt.

rdxOp
Ein Enumerationswert, der angibt, welchen Vorgang die Funktion ausführen soll. Die zulässigen Werte finden Sie in der Tabelle im Abschnitt "Hinweise".

pItem
Zeigen Sie auf die Daten, die aus der Registrierung gelesen oder in die Registrierung geschrieben werden sollen. Die Daten können auch einen Schlüssel darstellen, der aus der Registrierung gelöscht werden soll. Der Standardwert ist NULL.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

Hinweise

Die Makros BEGIN_RDX_MAP und END_RDX_MAP auf eine Funktion erweitert, die aufgerufen wird RegistryDataExchange.

Die möglichen Enumerationswerte, die den Vorgang angeben, den die Funktion ausführen soll, werden in der folgenden Tabelle angezeigt:

Enumerationswert Vorgang
eReadFromReg Lesen von Daten aus der Registrierung.
eWriteToReg Schreiben Sie Daten in die Registrierung.
eDeleteFromReg Löschen Sie den Schlüssel aus der Registrierung.

Anforderungen

Kopfzeile: atlbase.h

Siehe auch

Funktionen
Registrierungsdatenaustausch-Makros