ILocalRegistry4.GetLocalRegistryRootEx(UInt32, UInt32, String) Methode

Definition

Gibt den lokalen Registrierungsstamm zurück.

public:
 int GetLocalRegistryRootEx(System::UInt32 dwRegType, [Runtime::InteropServices::Out] System::UInt32 % pdwRegRootHandle, [Runtime::InteropServices::Out] System::String ^ % pbstrRoot);
int GetLocalRegistryRootEx(unsigned int dwRegType, [Runtime::InteropServices::Out] unsigned int & pdwRegRootHandle, [Runtime::InteropServices::Out] std::wstring const & & pbstrRoot);
public int GetLocalRegistryRootEx (uint dwRegType, out uint pdwRegRootHandle, out string pbstrRoot);
abstract member GetLocalRegistryRootEx : uint32 * uint32 * string -> int
Public Function GetLocalRegistryRootEx (dwRegType As UInteger, ByRef pdwRegRootHandle As UInteger, ByRef pbstrRoot As String) As Integer

Parameter

dwRegType
UInt32

[in] Ein __VsLocalRegistryType-Wert, der den Registrierungshive angibt.

pdwRegRootHandle
UInt32

[in] Ein __VsLocalRegistryRootHandle-Wert, der das Registrierungsstammhandle angibt.

pbstrRoot
String

[out] Zeiger auf eine Zeichenfolge, die den lokalen Registrierungsstamm enthält.

Gibt zurück

Int32

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.

Beispiele

ILocalRegistry4* pLocalRegistry = /* Get the local registry */  
VSLOCALREGISTRYROOTHANDLE hKey = RegHandle_Invalid;  
BSTR bstrPath = NULL;  
if( SUCCEEDED( pLocalRegistry->GetRegistryRootEx(  
    RegType_UserSettings, &hKey, &bstrPath ) ) )  
{  
    HKEY hkUser = NULL;  
    LONG lr = RegOpenKeyEx( hKey, bstrPath, 0, KEY_READ, &hkUser );  
    if( ERROR_SUCCESS == lr )  
    {  
        // Query values as needed  
        RegCloseKey( hkUser );  
    }  
    SysFreeString(bstrPath);  
}  

Hinweise

GetLocalRegistryRootEx sollte für den gesamten neuen Code verwendet werden, der Zugriff auf den Registrierungs Stamm benötigt. Die-Methode ermöglicht das Platzieren der computerspezifischen Konfigurations Teile der Registrierung unter einem anderen Registrierungsschlüssel und/oder Pfad.

Der entsprechende Dienst ist SID_SLocalRegistry

Diese Schnittstelle ist Thread sicher und kann von einem Hintergrund Thread direkt oder mithilfe eines gemarshallten Zeigers aufgerufen werden.

Gilt für