Funkcje globalne rejestru i elementu TypeLib

Te funkcje zapewniają obsługę ładowania i rejestrowania biblioteki typów.

Ważne

Funkcje wymienione w poniższych tabelach nie mogą być używane w aplikacjach wykonywanych w środowisko wykonawcze systemu Windows.

Nazwa/nazwisko	opis
AfxRegCreateKey	Tworzy określony klucz rejestru.
AfxRegDeleteKey	Usuwa określony klucz rejestru.
AfxRegisterPreviewHandler	Pomocnik do rejestrowania programu obsługi w wersji zapoznawczej.
AfxUnregisterPreviewHandler	Pomocnik do wyrejestrowania programu obsługi w wersji zapoznawczej.
AtlRegisterTypeLib	Ta funkcja jest wywoływana, aby zarejestrować bibliotekę typów.
AtlUnRegisterTypeLib	Ta funkcja jest wywoływana w celu wyrejestrowania biblioteki typów
AfxRegOpenKey	Otwiera określony klucz rejestru.
AfxRegOpenKeyEx	Otwiera określony klucz rejestru.
AtlLoadTypeLib	Ta funkcja jest wywoływana, aby załadować bibliotekę typów.
AtlUpdateRegistryFromResourceD	Ta funkcja jest wywoływana, aby zaktualizować rejestr z dostarczonego zasobu.
RegistryDataExchange	Ta funkcja jest wywoływana, aby odczytywać dane z lub zapisywać do rejestru systemowego. Wywoływane przez makra wymiany danych rejestru.

Te funkcje kontrolują węzeł w rejestrze używanym przez program do przechowywania informacji.

Nazwa/nazwisko	opis
AtlGetPerUserRegistration	Pobiera, czy aplikacja przekierowuje dostęp rejestru do węzła HKEY_CURRENT_USER ( HKCU).
AtlSetPerUserRegistration	Określa, czy aplikacja przekierowuje dostęp rejestru do węzła HKEY_CURRENT_USER ( HKCU).

Wymagania

Nagłówek: atlbase.h

AtlGetPerUserRegistration

Użyj tej funkcji, aby określić, czy aplikacja przekierowuje dostęp rejestru do węzła HKEY_CURRENT_USER (HKCU).

Składnia

ATLINLINE ATLAPI AtlGetPerUserRegistration(bool* pEnabled);

Parametry

pEnabled
[out] Wartość TRUE wskazuje, że informacje rejestru są kierowane do węzła HKCU ; FAŁSZ wskazuje, że aplikacja zapisuje informacje rejestru w węźle domyślnym. Domyślny węzeł to HKEY_CLASSES_ROOT (HKCR).

Wartość zwracana

S_OK, jeśli metoda zakończy się pomyślnie, w przeciwnym razie kod błędu HRESULT, jeśli wystąpi błąd.

Uwagi

Przekierowywanie rejestru nie jest domyślnie włączone. Jeśli włączysz tę opcję, dostęp do rejestru zostanie przekierowany do HKEY_CURRENT_USER\Software\Classes.

Przekierowanie nie jest globalne. Na to przekierowanie rejestru mają wpływ tylko struktury MFC i ATL.

Wymagania

Nagłówek: atlbase.h

AfxRegCreateKey

Tworzy określony klucz rejestru.

Składnia

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

Parametry

hKey
Dojście do otwartego klucza rejestru.

lpSubKey
Nazwa klucza otwieranego lub tworzonego przez tę funkcję.

phkResult
Wskaźnik do zmiennej, która odbiera uchwyt do otwartego lub utworzonego klucza.

pTM
Wskaźnik do CAtlTransactionManager obiektu.

Wartość zwracana

Jeśli funkcja powiedzie się, zwracana wartość jest ERROR_SUCCESS. Jeśli funkcja zakończy się niepowodzeniem, zwracana wartość jest kodem błędu niezerowym zdefiniowanym w pliku Winerror.h.

Wymagania

Nagłówek: afxpriv.h

AfxRegDeleteKey

Usuwa określony klucz rejestru.

Składnia

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

Parametry

hKey
Dojście do otwartego klucza rejestru.

lpSubKey
Nazwa klucza do usunięcia.

pTM
Wskaźnik do CAtlTransactionManager obiektu.

Wartość zwracana

Jeśli funkcja powiedzie się, zwracana wartość jest ERROR_SUCCESS. Jeśli funkcja zakończy się niepowodzeniem, zwracana wartość jest kodem błędu niezerowym zdefiniowanym w pliku Winerror.h.

Wymagania

Nagłówek: afxpriv.h

Pomocnik do rejestrowania programu obsługi w wersji zapoznawczej.

Składnia

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

Parametry

lpszCLSID
Określa identyfikator CLSID programu obsługi.

lpszShortTypeName
Określa wartość ProgID programu obsługi.

lpszFilterExt
Określa rozszerzenie pliku zarejestrowane w tej procedurze obsługi.

Wymagania

Nagłówek: afxdisp.h

AtlRegisterTypeLib

Ta funkcja jest wywoływana, aby zarejestrować bibliotekę typów.

ATLAPI AtlRegisterTypeLib(HINSTANCE hInstTypeLib, LPCOLESTR lpszIndex);

Parametry

hInstTypeLib
Dojście do wystąpienia modułu.

lpszIndex
Ciąg w formacie "\\N", gdzie N jest indeksem całkowitym zasobu biblioteki typów. Może mieć wartość NULL, jeśli indeks nie jest wymagany.

Wartość zwracana

Zwraca S_OK powodzenia lub błąd HRESULT w przypadku niepowodzenia.

Uwagi

Ta funkcja pomocnika jest używana przez bibliotekę AtlComModuleUnregisterServer i CAtlComModule::RegisterTypeLib.

Wymagania

Nagłówek: atlbase.h

AfxRegOpenKey

Otwiera określony klucz rejestru.

Składnia

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

Parametry

hKey
Dojście do otwartego klucza rejestru.

lpSubKey
Nazwa klucza otwieranego lub tworzonego przez tę funkcję.

phkResult
Wskaźnik do zmiennej, która odbiera uchwyt do utworzonego klucza.

pTM
Wskaźnik do CAtlTransactionManager obiektu.

Wartość zwracana

Jeśli funkcja powiedzie się, zwracana wartość jest ERROR_SUCCESS. Jeśli funkcja zakończy się niepowodzeniem, zwracana wartość jest kodem błędu niezerowym zdefiniowanym w pliku Winerror.h.

Wymagania

Nagłówek: afxpriv.h

AfxRegOpenKeyEx

Otwiera określony klucz rejestru.

Składnia

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

Parametry

hKey
Dojście do otwartego klucza rejestru.

lpSubKey
Nazwa klucza otwieranego lub tworzonego przez tę funkcję.

ulOptions
Ten parametr jest zarezerwowany i musi mieć wartość zero.

samDesired
Maska określająca żądane prawa dostępu do klucza.

phkResult
Wskaźnik do zmiennej, która odbiera uchwyt do otwartego klucza.

pTM
Wskaźnik do CAtlTransactionManager obiektu.

Wartość zwracana

Jeśli funkcja powiedzie się, zwracana wartość jest ERROR_SUCCESS. Jeśli funkcja zakończy się niepowodzeniem, zwracana wartość jest kodem błędu niezerowym zdefiniowanym w pliku Winerror.h.

Wymagania

Nagłówek: afxpriv.h

AfxUnregisterPreviewHandler

Pomocnik do wyrejestrowania programu obsługi w wersji zapoznawczej.

Składnia

BOOL AFXAPI AfxUnRegisterPreviewHandler(LPCTSTR lpszCLSID);

Parametry

lpszCLSID
Określa identyfikator CLSID programu obsługi do wyrejestrowania.

Wymagania

Nagłówek: afxdisp.h

AtlSetPerUserRegistration

Określa, czy aplikacja przekierowuje dostęp rejestru do węzła HKEY_CURRENT_USER (HKCU).

Składnia

ATLINLINE ATLAPI AtlSetPerUserRegistration(bool bEnable);

Parametry

bEnable
[in] Wartość TRUE wskazuje, że informacje rejestru są kierowane do węzła HKCU ; FAŁSZ wskazuje, że aplikacja zapisuje informacje rejestru w węźle domyślnym. Domyślny węzeł to HKEY_CLASSES_ROOT (HKCR).

Wartość zwracana

S_OK, jeśli metoda zakończy się pomyślnie, w przeciwnym razie kod błędu HRESULT, jeśli wystąpi błąd.

Uwagi

Przekierowywanie rejestru nie jest domyślnie włączone. Jeśli włączysz tę opcję, dostęp do rejestru zostanie przekierowany do HKEY_CURRENT_USER\Software\Classes.

Przekierowanie nie jest globalne. Na to przekierowanie rejestru mają wpływ tylko struktury MFC i ATL.

Wymagania

Nagłówek: atlbase.h

AtlUnRegisterTypeLib

Ta funkcja jest wywoływana, aby wyrejestrować bibliotekę typów.

Składnia

ATLAPI AtlUnRegisterTypeLib(
    HINSTANCE hInstTypeLib,
    LPCOLESTR lpszIndex);

Parametry

hInstTypeLib
Dojście do wystąpienia modułu.

lpszIndex
Ciąg w formacie "\\N", gdzie N jest indeksem całkowitym zasobu biblioteki typów. Może mieć wartość NULL, jeśli indeks nie jest wymagany.

Wartość zwracana

Zwraca S_OK powodzenia lub błąd HRESULT w przypadku niepowodzenia.

Uwagi

Ta funkcja pomocnika jest używana przez klasę CAtlComModule::UnRegisterTypeLib i AtlComModuleUnregisterServer.

Wymagania

Nagłówek: atlbase.h

AtlLoadTypeLib

Ta funkcja jest wywoływana, aby załadować bibliotekę typów.

Składnia

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

Parametry

hInstTypeLib
Dojście do modułu skojarzonego z biblioteką typów.

lpszIndex
Ciąg w formacie "\\N", gdzie N jest indeksem całkowitym zasobu biblioteki typów. Może mieć wartość NULL, jeśli indeks nie jest wymagany.

pbstrPath
Po pomyślnym powrocie zawiera pełną ścieżkę modułu skojarzonego z biblioteką typów.

ppTypeLib
Po pomyślnym powrocie zawiera wskaźnik do wskaźnika do załadowanej biblioteki typów.

Wartość zwracana

Zwraca S_OK powodzenia lub błąd HRESULT w przypadku niepowodzenia.

Uwagi

Ta funkcja pomocnika jest używana przez biblioteki AtlRegisterTypeLib i AtlUnRegisterTypeLib.

AtlUpdateRegistryFromResourceD

Ta funkcja została uznana za przestarzałą w programie Visual Studio 2013 i została usunięta w programie Visual Studio 2015.

<removed>

RegistryDataExchange

Ta funkcja jest wywoływana, aby odczytywać dane z lub zapisywać do rejestru systemowego.

Składnia

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

Parametry

Pt
Wskaźnik do bieżącego obiektu.

rdxOp
Wartość wyliczeniowa wskazująca, którą operację należy wykonać. Zobacz tabelę w sekcji Uwagi, aby uzyskać dozwolone wartości.

pItem
Wskaźnik do danych, które mają być odczytywane z rejestru lub zapisywane w rejestrze. Dane mogą również reprezentować klucz do usunięcia z rejestru. Wartość domyślna to NULL.

Wartość zwracana

Zwraca S_OK powodzenia lub błąd HRESULT w przypadku niepowodzenia.

Uwagi

Makra BEGIN_RDX_MAP i END_RDX_MAP rozszerzać do funkcji, która wywołuje RegistryDataExchangefunkcję .

Możliwe wartości wyliczenia wskazujące operację, którą powinna wykonać funkcja, są wyświetlane w poniższej tabeli:

Wartość wyliczenia	Operacja
eReadFromReg	Odczytywanie danych z rejestru.
eWriteToReg	Zapisywanie danych w rejestrze.
eDeleteFromReg	Usuń klucz z rejestru.

Wymagania

Nagłówek: atlbase.h

Zobacz też

Funkcje
Makra wymiany danych rejestru