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 . The $dname parameter may be NULL to indicate that the default domain of the supplied $px context should be returned.

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. See Issue 11 in the Plexcel Operator's Manual.

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>';