DestroyEnvironmentBlock function (userenv.h)

Frees environment variables created by the CreateEnvironmentBlock function.

Syntax

BOOL DestroyEnvironmentBlock(
  [in] LPVOID lpEnvironment
);

Parameters

[in] lpEnvironment

Type: LPVOID

Pointer to the environment block created by CreateEnvironmentBlock. The environment block is an array of null-terminated Unicode strings. The list ends with two nulls (\0\0).

Return value

Type: BOOL

TRUE if successful; otherwise, FALSE. To get extended error information, call GetLastError.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header userenv.h
Library Userenv.lib
DLL Userenv.dll

See also

CreateEnvironmentBlock

User Profiles Overview

User Profiles Reference