다음을 통해 공유


CRegKey::SetValue

지정한 값 필드에 데이터를 저장 하려면이 메서드를 호출 합니다. m_hKey. 이전 버전의이 메서드가 더 이상 지원 되지 및로 표시 된 ATL_DEPRECATED.

LONG SetValue( 
   LPCTSTR pszValueName, 
   DWORD dwType, 
   const void* pValue, 
   ULONG nBytes  
) throw( ); 
static LONG WINAPI SetValue( 
   HKEY hKeyParent, 
   LPCTSTR lpszKeyName, 
   LPCTSTR lpszValue, 
   LPCTSTR lpszValueName = NULL); 
ATL_DEPRECATED LONG SetValue( 
   DWORD dwValue, 
   LPCTSTR lpszValueName  
); 
ATL_DEPRECATED LONG SetValue( 
   LPCTSTR lpszValue, 
   LPCTSTR lpszValueName = NULL, 
   bool bMulti = false, 
   int nValueLen = -1 
);

매개 변수

  • pszValueName
    설정할 값의 이름을 포함 하는 문자열에 대 한 포인터입니다. 값이이 이름으로 이미 키에 없는 경우 메서드는이 키를 추가 합니다. 경우 pszValueName NULL 이거나 빈 문자열 "", 메서드 형식 설정 및 데이터에 대 한 키 이름 없는 또는 기본 값.

  • dwType
    포인터가 가리키는 데이터 유형을 나타내는 코드를 지정 된 pValue 매개 변수.

  • pValue
    이름으로 지정 된 값이 저장 될 데이터를 포함 하는 버퍼에 대 한 포인터입니다.

  • nBytes
    크기를 바이트 단위로 가리키는 정보 지정은 pValue 매개 변수. 데이터 형식이 REG_EXPAND_SZ, REG_SZ, REG_MULTI_SZ, 인 경우 nBytes 크기를 null 종결 문자를 포함 해야 합니다.

  • hKeyParent
    공개 키의 핸들입니다.

  • lpszKeyName
    키를 만들거나 열 이름을 지정 합니다. 이 이름은 하위 키의 해야 hKeyParent.

  • lpszValue
    저장 될 데이터를 지정 합니다. 이 매개 변수는 NULL 이어야 합니다.

  • lpszValueName
    설정할 값 필드를 지정 합니다. 값 필드에이 이름 가진 키에 없는 경우 추가 합니다.

  • dwValue
    저장 될 데이터를 지정 합니다.

  • bMulti
    False 인 경우 REG_SZ 형식입니다 나타냅니다. True 이면 문자열에 REG_MULTI_SZ 형식의 문자열입니다를 나타냅니다.

  • nValueLen
    경우 bMulti 는 nValueLen 의 길이가 lpszValue 문자열에 문자. 경우 bMulti false 값-1 나타내는 메서드 길이 자동으로 계산 됩니다.

반환 값

성공 하면 ERROR_SUCCESS를 반환 합니다. 그렇지 않으면 0이 아닌 오류 코드 WINERROR를 정의 합니다.H.

설명

두 원래 버전의 SetValue 로 표시 된 ATL_DEPRECATED 및 더 이상 사용 해야 합니다. 이러한 폼을 사용 하는 경우 컴파일러가 경고를 발급 합니다.

세 번째 메서드 호출 RegSetValueEx.

요구 사항

헤더: atlbase.h

참고 항목

참조

CRegKey Class

CRegKey::SetKeyValue

CRegKey::QueryValue

Registry Value Types