IWindowsMediaLibrarySharingServices::put_userHomeMediaSharingState method

The put_userHomeMediaSharingState method enables or disables sharing of the current user's media library on the home network.

Syntax


HRESULT put_userHomeMediaSharingState(
   VARIANT_BOOL sharingEnabled
);

Parameters

sharingEnabled

A VARIANT_BOOL that specifies whether sharing is enabled (VARIANT_TRUE) or disabled (VARIANT_FALSE) for the current user.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return codeDescription
S_OK

The method succeeded.

 

Remarks

If home media sharing is not allowed for the computer, other users will not have access to the current user's media library, regardless of whether home media sharing is enabled for the current user.

If home media sharing is allowed for the computer and home media sharing is enabled for the current user, other users on the home network will have access to the current user's media library.

Warning  If home media sharing is enabled for the current user, the computer updates the access control list (ACL) of each file in the user's media library to grant Read access to the NT SERVICE\WMPNetworkSvc account. This behavior might change in future versions of Windows.
 

Requirements

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Wmlss.h (include Wmlss.h)

DLL

WMPMediaSharing.dll

See also

IWindowsMediaLibrarySharingServices
IWindowsMediaLibrarySharingServices::get_userHomeMediaSharingState
IWindowsMediaLibrarySharingServices::put_computerHomeMediaSharingStateAllowed

 

 

Community Additions

ADD
Show: