Globální funkce registrace a TypeLib

Tyto funkce poskytují podporu pro načítání a registraci knihovny typů.

Důležité

Funkce uvedené v následujících tabulkách nelze použít v aplikacích, které se spouští v prostředí Windows Runtime.

Název	Popis
AfxRegCreateKey	Vytvoří zadaný klíč registru.
AfxRegDeleteKey	Odstraní zadaný klíč registru.
AfxRegisterPreviewHandler	Pomocná rutina pro registraci obslužné rutiny náhledu
AfxUnregisterPreviewHandler	Pomocník, který zruší registraci obslužné rutiny náhledu.
AtlRegisterTypeLib	Voláním této funkce se zaregistruje knihovna typů.
AtlUnRegisterTypeLib	Tato funkce se volá k zrušení registrace knihovny typů.
AfxRegOpenKey	Otevře zadaný klíč registru.
AfxRegOpenKeyEx	Otevře zadaný klíč registru.
AtlLoadTypeLib	Voláním této funkce se načte knihovna typů.
AtlUpdateRegistryFromResourceD	Voláním této funkce se registr aktualizuje ze zadaného prostředku.
RegistryDataExchange	Voláním této funkce se provede čtení nebo zápis v systémovém registru. Volal makra výměny dat registru.

Tyto funkce řídí, který uzel v registru program používá k ukládání informací.

Název	Popis
AtlGetPerUserRegistration	Načte, jestli aplikace přesměruje přístup registru k uzlu HKEY_CURRENT_USER ( HKCU).
AtlSetPerUserRegistration	Nastaví, jestli aplikace přesměruje přístup registru k uzlu HKEY_CURRENT_USER ( HKCU).

Požadavky

Hlavička: atlbase.h

AtlGetPerUserRegistration

Pomocí této funkce určete, jestli aplikace přesměruje přístup registru k uzlu HKEY_CURRENT_USER (HKCU).

Syntaxe

ATLINLINE ATLAPI AtlGetPerUserRegistration(bool* pEnabled);

Parametry

pEnabled
[ven] PRAVDA označuje, že informace registru jsou směrovány do uzlu HKCU ; FALSE označuje, že aplikace zapisuje informace registru do výchozího uzlu. Výchozí uzel je HKEY_CLASSES_ROOT (HKCR).

Návratová hodnota

S_OK, pokud je metoda úspěšná, jinak kód chyby HRESULT, pokud dojde k chybě.

Poznámky

Přesměrování registru není ve výchozím nastavení povolené. Pokud tuto možnost povolíte, přístup k registru se přesměruje na HKEY_CURRENT_USER\Software\Classes.

Přesměrování není globální. Toto přesměrování registru ovlivňuje pouze architektury MFC a ATL.

Požadavky

Hlavička: atlbase.h

AfxRegCreateKey

Vytvoří zadaný klíč registru.

Syntaxe

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

Parametry

hKey
Popisovač otevřeného klíče registru.

lpSubKey
Název klíče, který tato funkce otevře nebo vytvoří.

PhkResult
Ukazatel na proměnnou, která přijímá popisovač otevřeného nebo vytvořeného klíče.

pTM
Ukazatel na CAtlTransactionManager objekt.

Návratová hodnota

Pokud je funkce úspěšná, je vrácená hodnota ERROR_SUCCESS. Pokud funkce selže, návratová hodnota je nenulový kód chyby definovaný v winerror.h.

Požadavky

Hlavička: afxpriv.h

AfxRegDeleteKey

Odstraní zadaný klíč registru.

Syntaxe

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

Parametry

hKey
Popisovač otevřeného klíče registru.

lpSubKey
Název klíče, který se má odstranit.

pTM
Ukazatel na CAtlTransactionManager objekt.

Návratová hodnota

Pokud je funkce úspěšná, je vrácená hodnota ERROR_SUCCESS. Pokud funkce selže, návratová hodnota je nenulový kód chyby definovaný v winerror.h.

Požadavky

Hlavička: afxpriv.h

Pomocná rutina pro registraci obslužné rutiny náhledu

Syntaxe

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

Parametry

lpszCLSID
Určuje CLSID obslužné rutiny.

lpszShortTypeName
Určuje IDENTIFIKÁTOR ProgID obslužné rutiny.

lpszFilterExt
Určuje příponu souboru registrovanou v této obslužné rutině.

Požadavky

Hlavička: afxdisp.h

AtlRegisterTypeLib

Voláním této funkce se zaregistruje knihovna typů.

ATLAPI AtlRegisterTypeLib(HINSTANCE hInstTypeLib, LPCOLESTR lpszIndex);

Parametry

hInstTypeLib
Popisovač instance modulu.

lpszIndex
Řetězec ve formátu \\N, kde N je celočíselnou indexem prostředku knihovny typů. Pokud není vyžadován žádný index, může mít hodnotu NULL.

Návratová hodnota

Vrátí S_OK při úspěchu nebo chybu HRESULT při selhání.

Poznámky

Tuto pomocnou funkci využívá AtlComModuleUnregisterServer a CAtlComModule::RegisterTypeLib.

Požadavky

Hlavička: atlbase.h

AfxRegOpenKey

Otevře zadaný klíč registru.

Syntaxe

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

Parametry

hKey
Popisovač otevřeného klíče registru.

lpSubKey
Název klíče, který tato funkce otevře nebo vytvoří.

PhkResult
Ukazatel na proměnnou, která přijímá popisovač vytvořeného klíče.

pTM
Ukazatel na CAtlTransactionManager objekt.

Návratová hodnota

Pokud je funkce úspěšná, je vrácená hodnota ERROR_SUCCESS. Pokud funkce selže, návratová hodnota je nenulový kód chyby definovaný v winerror.h.

Požadavky

Hlavička: afxpriv.h

AfxRegOpenKeyEx

Otevře zadaný klíč registru.

Syntaxe

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

Parametry

hKey
Popisovač otevřeného klíče registru.

lpSubKey
Název klíče, který tato funkce otevře nebo vytvoří.

UlOptions
Tento parametr je rezervovaný a musí být nulový.

samDesired
Maska, která určuje požadovaná přístupová práva ke klíči.

PhkResult
Ukazatel na proměnnou, která přijímá popisovač otevřeného klíče.

pTM
Ukazatel na CAtlTransactionManager objekt.

Návratová hodnota

Pokud je funkce úspěšná, je vrácená hodnota ERROR_SUCCESS. Pokud funkce selže, návratová hodnota je nenulový kód chyby definovaný v winerror.h.

Požadavky

Hlavička: afxpriv.h

AfxUnregisterPreviewHandler

Pomocník, který zruší registraci obslužné rutiny náhledu.

Syntaxe

BOOL AFXAPI AfxUnRegisterPreviewHandler(LPCTSTR lpszCLSID);

Parametry

lpszCLSID
Určuje CLSID obslužné rutiny, která se má zrušit registrace.

Požadavky

Hlavička: afxdisp.h

AtlSetPerUserRegistration

Nastaví, jestli aplikace přesměruje přístup registru k uzlu HKEY_CURRENT_USER (HKCU).

Syntaxe

ATLINLINE ATLAPI AtlSetPerUserRegistration(bool bEnable);

Parametry

bEnable
[v] PRAVDA označuje, že informace registru jsou směrovány do uzlu HKCU ; FALSE označuje, že aplikace zapisuje informace registru do výchozího uzlu. Výchozí uzel je HKEY_CLASSES_ROOT (HKCR).

Návratová hodnota

S_OK, pokud je metoda úspěšná, jinak kód chyby HRESULT, pokud dojde k chybě.

Poznámky

Přesměrování registru není ve výchozím nastavení povolené. Pokud tuto možnost povolíte, přístup k registru se přesměruje na HKEY_CURRENT_USER\Software\Classes.

Přesměrování není globální. Toto přesměrování registru ovlivňuje pouze architektury MFC a ATL.

Požadavky

Hlavička: atlbase.h

AtlUnRegisterTypeLib

Voláním této funkce se zruší registrace knihovny typů.

Syntaxe

ATLAPI AtlUnRegisterTypeLib(
    HINSTANCE hInstTypeLib,
    LPCOLESTR lpszIndex);

Parametry

hInstTypeLib
Popisovač instance modulu.

lpszIndex
Řetězec ve formátu \\N, kde N je celočíselnou indexem prostředku knihovny typů. Pokud není vyžadován žádný index, může mít hodnotu NULL.

Návratová hodnota

Vrátí S_OK při úspěchu nebo chybu HRESULT při selhání.

Poznámky

Tuto pomocnou funkci využívá CAtlComModule::UnRegisterTypeLib a AtlComModuleUnregisterServer.

Požadavky

Hlavička: atlbase.h

AtlLoadTypeLib

Voláním této funkce se načte knihovna typů.

Syntaxe

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

Parametry

hInstTypeLib
Popisovač modulu přidruženého ke knihovně typů

lpszIndex
Řetězec ve formátu \\N, kde N je celočíselnou indexem prostředku knihovny typů. Pokud není vyžadován žádný index, může mít hodnotu NULL.

pbstrPath
Při úspěšném vrácení obsahuje úplnou cestu modulu přidruženého ke knihovně typů.

ppTypeLib
Při úspěšném vrácení obsahuje ukazatel na ukazatel na načtenou knihovnu typů.

Návratová hodnota

Vrátí S_OK při úspěchu nebo chybu HRESULT při selhání.

Poznámky

Tuto pomocnou funkci využívá AtlRegisterTypeLib a AtlUnRegisterTypeLib.

AtlUpdateRegistryFromResourceD

Tato funkce byla v sadě Visual Studio 2013 zastaralá a je odebrána v sadě Visual Studio 2015.

<removed>

RegistryDataExchange

Voláním této funkce se provede čtení nebo zápis v systémovém registru.

Syntaxe

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

Parametry

Pt
Ukazatel na aktuální objekt.

rdxOp
Hodnota výčtu, která označuje, kterou operaci má funkce provést. Seznam povolených hodnot najdete v tabulce v části Poznámky.

pItem
Ukazatel na data, která se mají číst nebo zapisovat do registru. Data mohou také představovat klíč, který se má odstranit z registru. Výchozí hodnota je NULL.

Návratová hodnota

Vrátí S_OK při úspěchu nebo chybu HRESULT při selhání.

Poznámky

Makra BEGIN_RDX_MAP a END_RDX_MAP rozbalí funkci, která volá RegistryDataExchange.

Možné hodnoty výčtu označující operaci, kterou má funkce provést, jsou uvedeny v následující tabulce:

Hodnota výčtu	Operace
eReadFromReg	Čtení dat z registru
eWriteToReg	Zapisujte data do registru.
eDeleteFromReg	Odstraňte klíč z registru.

Požadavky

Hlavička: atlbase.h

Viz také

Functions
Makra výměny dat registru