IWMSPublishingPoint::put_Name
Previous | Next |
IWMSPublishingPoint::put_Name
The put_Name method specifies the name of the publishing point.
Syntax
HRESULT put_Name( BSTR newVal );
Parameters
newVal
[in] BSTR that contains the name.
Return Values
If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.
Return code | Number | Description |
E_POINTER | 0x80004003 | Indicates that pVal is a NULL pointer argument. |
NS_E_DUPLICATE_NAME | 0xC00D0036L | Indicates that pVal is already being used by another publishing point. |
NS_E_INVALID_PUBLISHING_POINT_NAME | 0xC00D1455L | Indicates that pVal contains an invalid character. Invalid characters are: & " ' < > \ and the ANSI characters 0-31 and 127. |
NS_E_NAMESPACE_NAME_TOO_LONG | 0xC00D1392L | Indicates that pVal is longer than the maximum length allowed. |
NS_E_PUBLISHING_POINT_REMOVED | 0xC00D145AL | Indicates that the publishing point was already removed. |
NS_E_WRONG_PUBLISHING_POINT_TYPE | 0xC00D1452L | Indicates that the method is not supported for cache proxy publishing points. |
Remarks
The name must be unique. You can indicate the home publishing point by specifying only the forward slash character (/). There can be only one home publishing point, and it can be either a broadcast or on-demand publishing point. A home publishing point is not mandatory, but it enables clients to connect using the shorter URL formats such as protocol://server_name
and protocol://server_name/file_name
.
All other publishing point names must not contain a leading or trailing forward slash, but a forward slash character is permitted in the middle of a name. The following characters are not permitted:
< > \ ? % & ' # { } | ^ [ ] `
White spaces are permitted in the name, but the server will strip leading and trailing white spaces.
Example Code
EXIT: // TODO: Release temporary COM objects and uninitialize COM.
Requirements
Header: wmsserver.h.
Library: WMSServerTypeLib.dll.
Platform: Windows Server 2003 family, Windows Server 2008 family.
See Also
Previous | Next |