Synopsis

array plexcel_get_domain(resource $px, string $dname)

Description

The plexcel_get_domain function retrieves information about the named domain including it's dnsRoot , nETBIOSName and objectSid .

This function is particularly useful for canonicalizing usernames before calling plexcel_logon (e.g. convert EXAMPLE\username to username@example.com as required by plexcel_logon ).

Note: Currently this function cannot be used with NetBIOS domain names unless the corresponding DNS name is resolved first. Plexcel currently does not support NetBIOS name lookups.

Returns

The plexcel_get_domain function returns an array of attributes or FALSE to indicate that an error has occurred in which case plexcel_status should be consulted.

Example

The following PHP script prints information about the specified domain.

<?php

$dname = 'example.com';

$px = plexcel_new(null, null);
if (!$px)
    die('<pre>' . plexcel_status(NULL) . '</pre>');

$domain = plexcel_get_domain($px, $dname);
if ($domain === FALSE)
    die('<pre>' . plexcel_status($px) . '</pre>');

echo '<pre>';
print_r($domain);
echo '</pre>';